«i O HSM Command- 
I line Tasks 



Generally, HSM is configured from the graphical interface and 
requires very little day-to-day maintenance. This chapter 
describes die non-routine configuration and maintenance tasks 
that are performed mostly from the command line. 

• HSM Commands 

• Test Staging 

• Set Up Periodic Staging 

• Tuning for Staging to Tape 

« Coordinating Automatic Procedures 

• Working with Individual Files 

• Checking the Staging Configuration 

• Copying and Moving Data 

• Monitoring Storage Space and File Sizes 

• Maintaining Non-Stageable Filesystems 

• Managing Your Magnetic Disks 

• Populating Filesystems 

• Disabling Filesystem Staging 

• Compacting Staging Media 
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• Compacting Baseline Media 

• Clearing Incomplete Bitfiles 

• Gathering Migration Store Statistics 

• Checking a Network Client's Staging Configuration 

• Troubleshooting HSM 

• Restoring a Lost or Damaged Staging Volume 

• Restoring a Lost or Damaged Staging Trail 

• Restoring a Lost or Damaged Filesystem 



HSM Commands A brief description of the administrative and configuration 

commands available for local and network HSM systems can be 
found in "HSM Man Pages" on page 18-9- 



Test StaCjinQ Test that staging works by copying a large file, such as 

/'etc/termcap, to a stageable filesystem, stage it out, and verify 

that staging took place. Refer to the corresponding man pages 

for details concerning command arguments. 

emc# cd /homel 

emc# cp /etc/termcap 

emc# emstage termcap 

emcf emls 

Mag KB Stg KB Staging media Filename 

6 0 iost+found 

8 87 #0155-a doc termcap 



Set Up Periodic Staging Make sure an entry exists in root's crontab file for scheduling 
nightly, periodic staging runs. The following example is inserted 
into root's crontab file by the HSM installation procedure. 
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Minutes 



Hour 




Tuning for Staging tO Tape EDM with USA! option comes configured for staging to optical 
media. If you are staging to tape, you can improve performance 
by causing larger stage-ins, and thereby less tape repositioning. 

You do mis by using two parameters in the server's 
/usr/epoch/etc/msl/msl.cfg file and then enabling this modified 
configuration file. 

Optical media has a relatively quick seek time when compared 
to tape, Therefore, a small amount of data can be efficiently 
staged in from optical. This is how HSM is configured by 
default. 

For tape, however, reading small amounts of data for multiple 
users can cause thrashing against the tape drive. Larger stage-ins 
are required to cause less tape repositioning. Hie larger stage- 
ins are possible because magnetic media has a faster transfer 
rate than optical and a much greater storage density. 



The parameters are: 

• M SP_READ_AH EAD_PERCENTAG E 

The percentage of die file to be read on each read-ahead 
during a stage-in. It must be a whole number. 

• MSP_READ_AHEAD_MAX 

A throttle on MSP_READ_AHEAD_PERCENTAGE, it is the 
maximum number of bytes that are read on any give read- 
ahead. (This parameter is used to prevent the stage-in of a 
large file from taking over the system.) 

The default settings for optical are: 



Stage-to-Tape Tuning 
Parameters 
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MSP_READ_AHEAD_PERCENTAGE=25 

MS P_READ_AHEAD_MAX=1 04 8576 

If you are staging in from magnetic tape and have concurrent 
users you may want to change these to: 

MSP_READ_AHEAD_PERCEK 1 TAGE=34 
MS P_READ_AH EAD_MAX= 62914560 

For example, if a user tries to read in a 1 gigabyte file and the 
MSP_READ_AHEADJPERCENTAGE is 34, then HSM tries to read 
in 300 megabytes. 

If you set MSP_READ_AHEAD_MAX=62914560, die stage-in is 
limited to 60 megabytes (or about 1 minute of time). 



Stage-tO-Tape Tuning To edit these parameters and enable the modified configuration 

Procedure file: 

1. Edit the /usr/epoch/etc/msl/rnsl.cfg file to edit or add the 
two parameter values. 

Note: You should make a copy of the original 
/usr/epoch/etc/msl/rnsl.cfg file. 

2. Kill an emfmd daemon (killing one child process should kill 
them all). 

3. Do an init 6 
or 

Restart the emfmd daemons with: 
/usr/ epoch/ lib/msl /emfmd 



Coordinating Automatic To ensure maximum efficiency, you should coordinate all of the 
Procedures automatic backup and staging procedures that are run through 

root's crontab file. Table 13-1 shows two sets of recommended 
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order of tasks-, one for systems with only local HSM and backup 
and the other for systems with bail and network HSM and 
backup. 



Table 13-1 Recommended Order of Procedures in crontab 



System with local HSM 
and backup 


System with local and network 
HSM and backup 




1 . Client: periodic stage out 


1 . Server: emvck 


2. Server: emvck 


2. Server: periodic stage out 


3. Server: periodic stage out 


3. Server: compaction 


4. Server: companion 


4. Server: baseline backup 
(optional) 


5. Server: baseline backup 
(optional) 


5. Server: regular backup 


6. Server: regular backup 

7. Client; backup 

8. Server: database backup 



The remainder of this section provides additional detail for 
these activities. 

Backup automatically performs baseline backups before regular 
backups, and in sites with HSM clients, perform a database 
backup last. You only need to schedule client backups (step 7) 
after die server backup (step 6) in sites with HSM clients. 



Client (Periodic Stage Out) It is always best to stagger your network client's periodic- 

staging runs so that their activity does not overload the network 
or the server. If, however, you stage multiple clients simulta- 
neously, performance improves if the clients stage to different 
server disks. 
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Note: You should configure a larger delay factor (closer to 
twenty minutes.) for older and slower hardware with 
large files or a large numbers of files. 

If a client system has more than one stageable filesystem, 
stagger the staging of each filesystem by 12 to 20 minutes. It is 
especially important to set this delay factor on filesystems that 
contain large files of more than one MB. Running more than 
one staging operation simultaneously can degrade throughput. 

The following entry in root's crontab file starts a new staging 
day at 12:15 every night: 

15 0 * * * /bin/kill -HUP 'cat /usr /epoch/etc/mal/emmasterd . pid 1 > /dev/rrull 2>&1 

Refer to "Periodic Staging and Filesystem Delay" on page 11-22 
for further information. 



Server (emVCk) The emvck (volume check) program reads filesystem infor- 

mation on magnetic disk and compares it to the database. If the 
results for a staging volume do not match, it generates accurate 
counts, updates the database, and logs a message. 'lite 
following entry in root's crontab runs emvck at ] 1:45 even- 
night: 

15 23 * * * PATH=/usr/epoch/bin:$PATH;export PATH; emvck >/dev/nuil 2>&1 



Server (Periodic Stage Ollt) Schedule nightly periodic staging of all client stores. Stagger the 
staging so that the activity does not overload the optical library 
unit. 



Server (Compaction) schedule nightly compaction of staging volumes by running 

emcompact every night from root's crontab file. After the 
source volumes are compacted, they are made available tor 
reuse. 
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Check the message hies every day. If automatic compaction 
frequently fails to reach the free goal, the system may have 
reached its limit, given the number of volumes in the library 
unit. Use the dbreport compaction report to determine 
whether there is enough stale space to reclaim, or whether you 
should add more disks to your library unit. Refer to 
"Compacting Staging Media" on page 13-28 for further details. 



Server (Baseline Backup) Baseline backups are run automatically before regular backups. 

The recommended baseline backup procedure is to have 
backup templates use both primary and alternate trailsets, with 
both trailsets specifying a single baseline trail. 

You can back up die server, several clients, and the server 
database all within a single backup template. 



Server and Client (Backup) ebbackup should back up the server first and then your clients. 

If you are running network HSM, it is important to back up the 
client stores on the server, before you back up the clients. The 
following crontab entry starts a backup at 10:30 each night, 
using the backup template called default: 

30 22 * * * /usr/epoch/EB/bin/ebbackup default > /dev/null 2>-&l 

Refer to Chapter 14 "Stan of Backup and Related Processing" 
for more information. 



Server (Backup Database) Always back up the backup databases on die server after you 

back up the clients. This is also the case even if you have no 
network clients, because the server is considered a "local" client 
to the backup software. Database backups provide you with 
complete information about both the server and client backups 
and shorten disaster recovery time because they enable you to 
restore the database independently from the files that were 
already backed up. 
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By default, the backup software ensures that the backup 
database is backed up last. 



Rotating Error Logs Log files reside in a non-stageable filesystem in the 

/var/adm/epoch directory. To prevent the log files from 
growing excessively, the epnewlog script, which is run weekly 
from root's crontab file, will rotate or archive a log file to a 
stageable filesystem (/usr/epoch/adm/rotated) whenever the 
log file grows to more than one megabyte. The script rotates the 
concise log and the mntfault log using the usual Unix-style 
rotation scheme (*.0, M, *.2,...): 

The script archives the detail log permanently to 
/usr/epoch/adm/ archived using a date-based suffix. 

epnewlog does the following: 

1 . Moves each message log file from the /var/adm/epoch 
directory to the /usr/epoch/adm/rotated directory. For 
example, the message log file /var/adm/epoch/concise is 
moved to /usr/epoch/adm/rotated/concise. 

2. Makes each rotated log file in /usr/epoch/adm a version.O 
file. For example, the message log file shown in step 1 
becomes /usr/epoch/adm/rotated/concise.O. Each time 
cron runs the epnewlog script, the file suffix is incre- 
mented (.1,.2,.3) and finally deleted. 

3. Assigns a date-based suffix to the detail log file in 
/usr/epoch/adm/ archived. 

4. Creates new message files in the /var/adm directory. 

5. Restarts the syslogd process. 

For the rotated log files, this procedure saves an entire month's 
worth of log data by rotating the log file names: messages.O -> 
messages.! -> messages.2 -> messages.3 -> deleted. Because 
the messages.10-31 log files are in the /usr filesystem and are no 
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longer growing, they are now candidates for HSM to staging 
devices. Use a similar approach if you've configured any other 
log files. 



Working with Individual The HSM Configuration interface handles data among several 
Files layers in a storage hierarchy. However, the software also 

provides command-line tools for manipulating individual files. 

'I 'he following procedures describes these tools: 

• Staging out files 

• Staging in a set of files 

• Tagging a set of files for future stage out 

• Locking a file on magnetic disk 



Staging Ollt Files During normal system use HSM manages staging for you. There 

are times, however, when you know that a group of files is no 
longer needed. For example, when you finish a project, you can 
explicitly stage those files out. 

Use the emstage command to stage out or prestage one or 
more files. The following example stages out the files, drawing] 
and drawing2: 

emc% emstage drawingl drawing2 

There are command line arguments that let you prestage files, 
to recursively descend subdirectories while staging, to follow 
symbolic links, to stage to a particular volume, and to stage to a 
volume that contains a particular file. See the emstage man 
page for details. 



Staging In a Set Of Files If you know that a group of staged-out files are needed soon, 

you can use the embsi command to stage them in. The embsi 
command stages the files in and attempt to make them all 
resident on magnetic disk. 
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By default, embsi does not attempt to stage in files if there is 
not enough available space for them on magnetic disk. Also, by 
default, embsi does not update access times. To force embsi to 
stage in files even if not enough magnetic disk space is 
available, use the -f option; to update access times, use the -a 
option. 

When access times are not updated, embsi estimates available 
free space; when access times are updated, embsi estimates the 
total disk space in the filesystem. If not enough space is 
available, embsi displays the amount required and its estimate 
of the amount available. You can select a smaller set of files to 
stage in, explicitly stage out files, or force the stage in. 

Forcing a bulk stage in, when there is not enough space, almost 
certainly means that HSM will have to stage out some files. If 
the access times are updated, the chances are that many of the 
files that are being staged in remain on magnetic disk and other 
files are staged out. If the access times are not updated, the 
chances are mat at least some of the files being staged in do not 
remain on magnetic disk. 

The following example recursively stages in all the files in the 
current directory: 
emc% embsi -r . 



Use emchmod -C to tag files so that they are staged out at the 
next convenient time, which is usually die next periodic staging 
run. Remember that, emchmod, unlike chmod, clears 
properties if they are not specified on the command line. 
Therefore, you should always use emls -1 first to determine the 
properties that are already set. You must be superuser or the 
owner of the file(s) to change properties. 

To tag a set of files for future stage out: 
1 . Change to die directory that contains the files you want to 
stage out. 
emc# cd archive 
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Use emls -1 to determine the properties that are already set. 
emci emls -1 * 

Staging media Volume barcodes Filename 

0 " filexyz 

0 #002-a Archive fileabc 



3, Use emchmod with the -C option to indicate that the 
specified files should be staged out at the next convenient 
time. (The -P option sets the residence priority.) 
emci emchmod -C -P36 filexyz 



Locking a File On Magnetic Use emchmod -1 to lock file(s) on magnetic disk and prevent 

DlSk die files from being staged out. Remember that, emchmod, 

unlike chmod, clears properties if they are not specified on the 
command line. Therefore, you should always use emls -1 first to 
determine the properties that are already set. You must be 
superuser or the owner of the file(s) to change properties. 

To lock a file on magnetic disk: 

1 . Change to the director}' that contains the subdirectory or 
files you wish to lock on magnetic disk. 

emc# cd archive 

2. Use emls -1 to determine the properties that are already set. 
emc# emls -1 * 

Mag KB Stg KB 1-flags Flags Staging media Volume barcodes Filename 

1024 0 0 60 - filexyz 

24 898 0 0 #002-a Archive fileabc 

1 0 --CK 60 0 - dirabc 

3. Use emchmod with the -1 option to lock the specified files 
on magnetic disk. 

emc# emchmod -1 filexyz 
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Consider locking down VxFS reserved files. Reserved files are 
configured on VxFS to remain on the magnetic disk, so they are 
good candidates for locking. See the VxFS documentation for 
information on reserved files. 

Locking too many files can seriously impact HSM performance. 
Before you lock files onto magnetic disk, try small changes to 
the residence priority (see the emchmod man page). Be careful 
about setting the inheritable lock property on a directory. All 
files and directories created below that point inherit the lock 
property. 



Checking the Staging Use the emcheck command to check the staging configuration. 

Configuration you must be su peruser to run emcheck. If you type the 

command without any arguments it checks the configuration 
database, warns you of potential problems and corrects incon- 
sistencies. If you use the -v switch (verbose) you see more 
information. If you use the -r switch (read-only), emcheck 
does not correct any problems that it may find. 

The emcheck command checks the database in eight phases. 
The first four phases, D1-D4, verify the semantics and the 
syntax of the configuration database. The second four phases. 
S1-S4. verify the system as a whole. 

The emcheck command displays the following lines: 
bet at /usr/epoch/bin/emcheck 

*** Phase Dl - Checking configuration database files 

*** Phase D2 - Checking status of Epoch Migration servers 

*** Phase D3 - Checking store database against server config 

*** Phase D4 - Checking status of stores 

*** Phase SI - Check Epoch Migration directories 

*** Phase S2 - Check for running Epoch Migration daemons 
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Copying and Moving Data With HSM you have the ability to store vast amounts of data 

throughout your network. Often you may find the need to copy 
or move data from one location to another - between 
filesystems, network clients, or servers, for example. This 
section provides step-by-step instructions for copying and 
moving large amounts of data between various locations in your 
network. The topics are: 

• Migrating data from one staging trail to another 

• Copying files from one filesystem to another 

• Moving and copying files between HSM systems 
a Copying files between network HSM clients 

• Copying files to a non-EDM system 



Migrating Data from One Alter you've had your system for a while, you may want to 

Staging Trail tO Another archive some older data to tape or optical disk. To do this, use 

the restage command on the EDM server to migrate files from 

one staging trail to another. 

1 . Decide which staging trail you want to restage the data to. 

2. If necessary, create a new staging template/trail with the 
emstconf command. 

3. Use the restage command to migrate the data from the 
existing staging trail to the new one. 

The following command moves staged files from the doc 
trail to the tapeljrail. The command moves only those files 
that haven't been modified or accessed in tine last 30 days. 
# restage -t tapel_trail -R /datal -mtime +30 \ -atime +30 -staged_to_trail doc 

See the restage man page for additional examples. 
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The Fastest, most efficient way to move or copy large amounts 
of data from one filesystem to another is with the ebcp 
command. The ebcp command copies files from one place to 
another within an HSM-enabled system, between HSM-enabled 
systems, or from an HSM-enabled system to a non-HSM system. 

The ebcp command automatically determines whether the 
destination filesystem is under HSM control. If so, ebcp copies 
the files that are no! staged out to the new location. In addition, 
ebcp will create a filesystem entry for staged-out files and 
attach these entries to their staged images. If the destination 
location is not under HSM control, ebcp will copy everything, 
including the files that are staged out. 

When copying to a filesystem that is not under HSM control, 
you must be sure that enough space is available to hold all of 
the files that are copied. 

The following example copies all of the files in the /data! 
filesystem to the /data2 filesystem on the same HSM-enabled 

1 . Change to die source directory: 
emc# cd /datal 

2. Use ebcp to copy the files: 
emc# ebcp . /data2 

After you copy the files, you can delete the originals. 



There are two general approaches to copying files between 
HSM-enabled systems. Both approaches use the ebcp 
command. In the first approach, you simply copy all of the files 
and directories from one fileserver to another, including every- 
thing that is staged out, without transferring the staging media 
to the new fileserver. 



Copying Files from One 
Filesystem to Another 



Moving and Copying Files 
Between HSM Systems 
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In the second approach, you copy only the magnetic-resident 
data to the new fileserver and then reattach to the staging 
media. This second approach is significantly faster and is 
especially recommended when the quantity of data is too great 
to transfer over the network. 



Copying Files to Another HSM The following example copies all of the files, including die files 

System (No Media) that are staged out, in the /data] filesysteni on a system named 

"emc" to the /data2 filesystem on a system named "emc2." This 
example will work on any system configured for HSM 
(fileservers and clients). 
# ebcp -o /datal | rsh emc2 /usr/epoch/bin/ebcp \ -i /data2 

Note that ebcp does not update directory modification and 
access times, unless you issue the command a second time, 
using the -dlr switch. See the ebcp man page for details. 



Moving Files to Another EDM (Media The following example copies all of the files that are not staged 
Included) out from the /data] filesystem on a system named emc to the 

/data 2 filesystem on a system named emc2. This example uses 
the -local switch so that ebcp reattaches files to the imported 
staging media rather than copy the staged-out files. 

1. Insert all of the source machine's staging media into the 
inlet of the destination machine's library unit. Do not press 
any of the buttons on the front of the library unit, 

2. Use the Library Unit Manager to import all of the volumes. 

3. Run ebfcjbmport -a to complete the import. 
emc2# /usr/epoch/bin/ebf s_import -a 

4. Use ebcp to copy the files that aren't staged out to the new- 
system and to reattach staged-out files to their staged 
images. Note that mis example only works with the primary 
staging media. The secondary staging media (the baseline 
backups) cannot be moved. (Hie -R IS switch, which tells 



EDM Software Reference 



13-16 

HSM Command-line Tasks 



ebcp not to copy the baseline information, is actually an 
option to recxcpio. See the recxcpio man page for 
details.) 

emc# ebcp -o -local /datal | rsh emc2 \ /usr/epoch/bin/ebcp -i /data2 -R IS 

5. After die copy has completed, yon can delete the files on 
the source machine. 



Moving Files Between HSM Clients It is also possible to copy a large set of files, or an entire 
(Store Included) filesystem, from one network client to another. You can use 

ebcp to copy the magnetic-resident files to the new client and 
simply change the ownership of the client store from one 
system to another. 

Note: If other filesystems are staging to the store, you 
need to repeat this procedure for each filesystem. 

The procedure is as follows: 

1 . Bring the source filesystem to an inactive state. 

2. On the EDM, use emschs to change the ownership of the 
client store from the source to the destination client. 

The following command changes the ownership of the 
alpha_all store to a network client named beta: 
emct emschs alpha_all -c beta 

3. On the EDM. use emsmvs to change the name of the store 
from alpha_all to beta_all: 

emci emsmvs alpha_all -n beta_all 

4 . If necessary, create a staging template on the destination 
system and configure die destination filesystem for staging. 

5. Copy all the files from the datal filesystem on die network 
client named alpha to the /datal filesystem on die network 
client named beta: 

alpha# ebcp -o -local /datal I rsh beta \ /usr/epoch/bin/ebcp -i /datal -R IS 

6. Repeat the procedure for all other client filesystems that 
stage to the same client store. 



EDM Software Reference 



13-17 



Copying and Moving Data 



7. After die copy completes, delete the files on the source 
machine. 



Restoring a Staged Out File When a file is staged out from an HSM client to a client store, 
That Has Been Deleted the bitfile gets backed up by the fileserver's backup, and the file 

attributes that remain on the client get backed up by die client 
backup. If someone deletes the file, both die attributes on the 
client and the bitfile on the fileserver are deleted. You will not 
be able to access the file's data until the attributes have been 
restored on the client and the bitfile has been restored on the 
fileserver. 

To restore the staged-out file: 
] . On die client run edmrestore to start the EDM Restore 
window. 

Select the client and work item. 
Select the deleted file from the list. 
Verify the destination and start die restore. 
Run emsundel on die EDM server to restore the bitfile. 
emc# emsundel 

emsundel by default restores all deleted stores that have 
been recovered. The command should be run regularly 
from an entry in the root's crontab file. If you can wait, let 
the emsundel crontab entry restore die bitfile. The 
emsundel man page describes how restrict emsundel to a 
single store and force it to use a specific backup template. 



It is also possible to use ebcp to copy data from an 1ISM- 
enabled system to any Unix system. This example copies all 
files in the /datal fUesystem, including the files that have been 
staged out, on a system named "emc" to the Amp/output 
filesystem on a system named "colt." 
1 . Change to the source directory: 



3. 
4. 
5. 



Copying Files to a Non-EDM 
System 
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emc# od /datal 

2. Mount the destination filesystem on your EDM: 
emc# mount colt: /tmp/output /mnt 

3. Use ebcp to copy the files: 
emc# ebcp . /mnt 

4. After the copy has completed, you can delete the files in the 
source filesystem. 



Monitoring Storage Space hsm provides several tools that enable you to monitor storage 

and File SizeS space and file sizes. These tools are listed in Table 13-2. See the 

man pages for further information. 



Monitoring Commands 


If you want to: 


Use this command: 


Show magnetic disk space used by direc- 


enidu 


tories. 




Show magnetic disk space used by direc- 


cmdu -a 


tories and individual files. 




Show virtual storage space used by staged- 


emdu -av 


out directories and files; also shows 




magnetic disk space used by magnetic- 




resident directories and files. 




Find out what staging volume a file resides 


emls 


on and show file sizes on magnetic disk and 




staging media. 




Show information about used and available 


df 


disk space for each filesystem. (Syntax and 




display may vary from system to system.) 




Show information about used and available 


df-g 


inodes for each filesystem. (Syntax and 




display may vary from system to system.) 
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Table 13-2 Monitoring Commands (Continued) 



If you want to: Use this command: 



List all the volumes in a staging trail and dbreport appl_usage 

obtain information about current staging 

volumes. 

Determine which staging volume to dbreport compaction 

compact. 

Display virtual filesystem statistics, emfsreport 



Maintaining Non- The root filesystem and the filesystem that contains the EDM 

StagBablfi FlleSyStemS software cannot be configured for HSM because they contain 

files that must not be staged out. These and any other non- 
stageable filesystems can therefore fill up. 

The most likely reason that these filesystems would fill up is 
some sort of unexpected activity, either accidental or deliberate. 
If a filesystem becomes full, find files that can be deleted and 
determine why usage is increasing. Do the following to 
determine the cause of the problem: 

• Use ps to determine what processes are running and kill 
any unexpected ones. 

• Look at /trap and /usr/tmp and delete any unnecessary 
temporary files. 

• Use find to look for new files in the root filesystem, 

• Examine the HSM log files in /usr/cpoch/adm/archtved. 



Managing YOUr Magnetic If a filesystem is constantly staging files in and out, it may have 

DiSkS an inadequate working set. The working set is the amount of 

stageable magnetic data that a filesystem can hold without 
exceeding its low "watermark. 
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The working set is often measured as the number of days worth 
of files that are stored on the magnetic disk. This is called the 
ivorkingset in days. For most non-archival applications, you 
should have a working set period of at least one to four weeks. 
If your working set of files is considerably larger than your 
actual magnetic disk space, you will experience system perfor- 
mance degradation. 

Use the emfsreport tool to display virtual filesystem statistics 
and to develop a coherent strategy for managing your magnetic 
disks: 

1. Run emfsreport to display virtual filesystem statistics. 

2. Decide how many days worth of data you need to keep on 
the magnetic portion of a filesystem. 

3. Determine the additional magnetic disk space you'll need. 

4. Reconfigure your magnetic disk usage or purchase more 
disks. 

These steps are described in detail below. 



Run emfsreport Use emfsreport to find out your working set size and die 

working set in days, so that you can fine tune your system. To 
run emfsreport, become root and specify either the name of a 
locally mounted filesystem, or use the -a switch for all 
filesystems. For example: 
emc# emfsreport -hva /data2 

A sample report is shown in Figure 13-1. It displays die amount 
of space used by all files in the /data2 filesystem, regardless of 
their location. (Note that virtual space takes into account space 
consumed on magnetic disk plus space consumed on the 
staging media.) 
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Figure 13-1 



emfs report Output 



/data2 



TOTAL 



REGULAR 



DIR 



SYMLNK | 



Number of files 
GB of stagable data 
GB of not stagable 
GB of data staged 
Virtual GB of data 
Stagable Vir-Phs ratio 
Actual Vir-Phys ratio 



218502 
0.33680 
0.11482 
1.20944 
1.59746 
4.743:1 



105169 
0.33680 
0.00511 
1.20944 
1.48775 
4.417:1 
4.351:1 



17160 | 

0.00000 | 

0.01800 I 

0.00000 | 

0.01800 | 

1.000:1 | 

1.000:1 | 



0.00000 | 

0.00000 | 

0.00000 I 

0.00000 I 

1.000:1 | 

1.000:1 | 



96173 | 

0.00000 ! 

0.09171 | 

0.00000 | 

0.09171 | 

1.000:1 I 

1.000:1 [ 



GB available for working : 
(About 5.6 days worth.) 



Histogram of virtual space by file age for regular files: 

Range of days old ] count | % ] cum % | Kbytes S % I cum % | KB per 



31. 99 
63.99 
127. 99 
255. 99 

511. 99 
1023. 99 



14489 
4746 
3778 
6572 
1738 
3679 
7687 
41762 
13370 
5789 
1544 



3.59 
6.25 



13.78 i 

18.29 | 
21.88 | 
28.13 | 
29.78 | 
33.28 I 
40.59 I 

80.30 ! 
93.01 ! 
98.52 ] 
99.99 | 



158394 
58962 
69728 

106640 
39844 
88144 

221259 



162142 
122504 
44013 



4.47 
6.84 



10.15 I 
13.93 I 
18.40 1 
25.24 | 
27.79 I 
33.44 1 
47.63 | 
78.92 | 
89.31 I 
97.17 | 
99.99 I 



ChOOSe the Desired Working Using the values displayed in Figure 13-1, you can calculate 
Set in Days how much more magnetic space you would need for a desired 

working set size in days, Figure 13-1 shows that /data2 has 353 
MB available in its worldng set, with a working set in days of 
5.6 days. Once you learn what your working set size in days is, 
you may decide that it is too small. (Remember, EMC recom- 
mends you have a working set period of at least one to four 
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weeks.) Select an adequate number of days based on your 
usage patterns. See "emfsreport and the Working Set" on page 
11-31 and "Disk Utilization Zones" on page 11-13 for some 
additional considerations. 



Determine Additional The sample report of /data2 shows that the filesystem has a 

Magnetic Disk Space Required working set of 5.6 days. Suppose that is unacceptable and you'd 

rather have a working set of 14 days. How much additional 

magnetic disk space would you need? 

To estimate, simply pick the high day range that falls closest to 
your desired working set size. In this case the day would be 
15.99. 

1. Multiply the value on the "Kbytes cum%" line (27.79) by the 
total number of Kbytes (1560023) to get die working set 
size in KB. For example: 

Working set size in KB = .2779 * 1,560,023 
The result is 433530.39 KB. 

2. Take the result of die previous calculation (433530.39) and 
divide by 1024 to get the working set size in MB. 
Working set size in MB = 433530.39/1024 

The result is 423.37 MB. 

3. Take the result of die previous calculation (423.37) and 
divide by 1024 to get die working set size in GB. 
Working set size in GB = 423.37/1024 

The result is 0.41 GB. 

4. Subtract the GB available for the working set (0.353) from 
0.410 and multiply by 1024 to get the number of additional 
magnetic space needed in MB. 

Mag Disk Space needed = (.410 - .353) ' 1024 
The result is 58.37 MB. 
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Thus you would need approximately 58.37 Mbytes more 
magnetic disk space on this filesystem in order to have a 
working set of 15.99 days. (You can extrapolate to find die 
exact requirements for a working set size of 14 days.) 



Reconfigure Magnetic Disk Or Depending on your site's configuration, your budget, and the 
Purchase More DiSkS amount of time you have, there are a number of actions you 

can take to better utilize your magnetic disk resources; 

• Move files to another filesystem that is under utilized. This 
filesystem may be on the same or on another magnetic disk. 

• Repartition your disk. Take a complete backup of your 
filesystems, repartition your disk and restore your files. 
When repaititioning your disk, make die partitions corre- 
spond to their working set needs; make some partitions 
smaller and some larger. 

• Add magnetic disks if you are using all of your current disk 
space and have no where else to relocate the files. 



Populating FileSyStemS The most efficient way to move files from a non-HSM system to 
an HSM system is to make the HSM system an NFS client of the 
other system and to use tar to read the data. For example, to 
copy /user] on another system to /datal/userl on the HSM 
system, use the following procedure: 

1. Configure the other system as an NFS server for its /userl 
filesystem. 

2. Login to the HSM system as root, make a temporary 
directory, and temporarily mount the server's /user! as a 
remote filesystem: 

emcf mkdir /other_userl 

emcf mount -o , ro , hard , intr serv: /userl /other_userl 



EDM Software Reference 



13-24 



HSM Command-line Tasks 



3. Change to the remote filesystem and use tar in a pipeline to 
copy files to the new filesystem on the HSM system. Then, 
unmount the remote filesystem and delete the temporary 
directory: 

emcl mount -F vxfs -o remount , nolog /datal 
emc# cd /other_userl 

emc# tar cBf - . I (od /datal /user 1 ; tar xBpf -) 

emc# cd / 

emc# uraount /other_userl 
emc# rmdir /other_userl 

An HSM-enabled system can also be populated by configuring it 
as an NFS server, configuring the other system as the client, and 
using tar on the client system to "push" the files to the HSM 
system. Because NFS read performance is generally better than 
NFS write performance, the best approach is to make the HSM 
system the client and "pull" the files from the server. 

When populating an HSM system with archival files, that is, files 
that you want to move quickly to staging media, you can set the 
convenient property (-C) on the directory that contains the files. 
Then, any file loaded into that directory (or subsequently 
created subdirectories) will be staged out during the next 
periodic staging run. See the emchmod man page for details 
about the convenient property. 

For details on moving data from one EDM to another, see 
"Moving and Copying Files Between HSM Systems" on page 
13-14. 



Disabling Filesystem There are two ways to disable staging. You can temporarily 

StSCjillQ disable periodic staging for an entire system, for a staging 

template, or for an individual filesystem. Or, you can perma- 
nently disable both periodic and demand staging. 
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Temporarily Disabling Periodic By changing the enable value from Y to N in either the 
Staging emsysconf command, the emstcoiif command, or the 

emfsconf command, you can temporarily disable periodic 

staging for an entire system, for a staging template, or for an 

individual fiiesystem. 

emci emsysconf N 20 R 

emci emstconf CRD N ----- - -OR 

emci emfsconf /mech N - - - - CADOR 

See the man pages for details regarding command syntax. 

The enable value only affects periodic staging; it has no effect 
on demand staging (crossing a high watermark), user-specified 
staging (emstage and restage), baseline backup, or stage-in. 



Permanently Disabling Use the following procedure to permanently disable fiiesystem 

Periodic and Demand Staging staging, that is, periodic and demand stage-out and stage-in. 

This procedure not only disables staging, but it also stages in all 
staged-out files. If the fiiesystem does not have the room, you 
can move the staged-out files to another fiiesystem. See 
"Copying Files from One Fiiesystem to Another" on page 13-14. 

To preserve data integrity, you must follow this procedure 
exactly as described. 

1. Make sure you have a valid set of backups for the 
fiiesystem. 

2. Become superuser. 

3. Change permissions on the root of the target fiiesystem to 
allow only rwx access by root. (Before you change the 
permissions, do an Is -lad to determine what the current 
permissions are. You reinstate these permissions at a later 
date.) 

emci Is -lad /alpha 

drwxr-xr-x 9 root 512 Sep 4 15:40 /alpha 
emc# chmod 700 /alpha 
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4. Disable periodic and demand staging. Note that this step 
prevents periodic and demand staging, but it does 770/ 
prevent users from staging specific files. At this point, users 
can still access staged out files. 

entct emfsconf -r /alpha 

5. Disable compaction by commenting out or editing the 
appropriate line in root's crontab file. The default 
compaction line is as follows-. 

00 1 * * * /usr/epoch/bin/emcompact -c 
>/dev/null 2>&1 

In addition, abort any compactions in progress. 

6. Disable baseline backups from the Backup Configuration 
interface. 

c. From the EDM main view's Backup menu, select 
Configure. 

d. On the Server tab select Disable baseline backups. 

e. Select Save, then exit EDM. 

7. Shutdown the system and then reboot. This ensures that no 
one is logged in and severs any remote connections to the 
system. 

Note: Use only /usr/sbin/shutdown -y -i6 -gO 

on an HSM system. Do not use halt or reboot. 

8. Use emfsreport to determine whether enough free space 
is available to stage in all of the staged-out files. The 
important line to look at in the emfsreport display is the 
Virtual GB of data (239-35 MB, in this example): 
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emct emfsreport /alpha 



/alpha | TOTAL | REGULAR | DIR | SPECIAL 1 SYI 



Number of files i 




16701 | 




5799 I 




1818 | 




0 i 






GB of stagable data | 


0 


20034 | 


0 


20034 | 


0 


00000 | 


0 


00000 | 


0 


0 


GB of not stagable I 


0 


0134 0 | 


0 


00288 | 


0 


00185 | 




00000 | 


0 


0 


GB of data staged ] 


0 


03130 | 


0 


03130 1 


0 


00000 | 


0 


00000 1 


0 


0 


Virtual GB of data [ 


0 


23935 | 


0 


22884 | 


0 


00185 | 


0 


00000 1 


0 


0 


Stagable Vir-Phs ratio | 


1 


195:1 i 


1 


142:1 I 


0 


000:1 1 




000:1 1 


0 


0 


Actual Vir-Phys ratio 




120:1 | 


1 


126:1 1 


1 


000:1 | 


0 


000:1 | 




0 



GB available for working set: 0.230 
(About 572.1 to 739.6 days worth.) 
(Range given because 1% of virtual space 

9. If you do not have enough free space to stage in all of the 
staged-out files, refer to the following section. 

10. Run emfsdeconfig to complete the procedure. 
emc# emf sdeoonf ig /alpha 



Moving Staged Out Files tO If the filesystem does not have enough space to hold all of the 

Another Filesystem staged-out files, proceed as follows: 

1 . Change to the /alpha directory. 

2. Use ebcp to copy the files to another filesystem, which may 
be stageable or non-stageable. The following example 
copies all of the files in /alpha to /new_alpha. 

emc# ebcp . / new_alpha 

3. Delete the files in the /alpha filesystem. 

4. Unmount the /alpha filesystem to clear data structures used 
for stageable filesystems. 

emct umount /alpha 

5. Recreate the /alpha filesystem. 
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Compacting Staging In most cases, staging media is compacted automatically via an 

Media emcompact entry in root's crontab file. With automatic 

compaction, emcompact automatically determines which 

volumes to compact. 

You can also compact staging volumes manually, if you want to 
compact any additional volumes. Both automatic compaction 
and manual compaction use the emcompact command. 

If you need to compact some staging volumes manually: 

1 . Use dbreport's compaction report to decide which 
volumes to compact. 

emct dbreport compaction 

The compaction report is divided into three sections. The 
most likely volumes to compact are those that are listed in 
the last few lines of die first section. These are the volumes 
with the highest percentage of stale files. 

2. Use emcompact to compact the volumes. In the case of 
EOs, which have two sides, you need to specify each side, 
or volume, separately. You can specify volumes by: 

- volume id 

sequence number (for single-sided media) 

- sequence number and side (for double-sided media) 

- barcode (for single-sided media) 

The following example compacts both sides of disk #10: 
emct emcompact EO 10-1 10-2 

You can type the command without any arguments to find 
out the legal media types. (In the case of tapes, you can 
specify a barcode.) 

You can override HSM's file residence policy by running 
emcompact with the — p (policy) option. The -p option 
ensures that all files from the compaction source volume 
are staged out to the compaction output volume and none 
remain on magnetic disks. 
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Administering Compaction There are several things you can do on a regular basis to make 

sure that compaction is working smoothly. 

CAUTION: In order to ensure a complete file restore 
process, you should disable automatic 
compaction and emvck as soon as you realize 
that you've lost a filesystem or a significant 
portion of one. 

• Check the Media Requests window every morning to see if 
automatic compaction has blocked. 

• Keep a supply of blank, easily accessible and unlabeled 
volumes, which you can label and allocate as compaction 
output volumes. 

To increase the likelihood of maintaining a supply of free 
volumes, you can also convert unrestricted staging trails to 
restricted ones, or prelabel volumes for a specific trail. 

• Check the message files every day. 

If automatic compaction frequently fails to reach the free 
goal, the system might have reached the limit of its data 
storage, given the number of volumes in the library unit or 
the time available for compaction. 
In such a case, use the dbreport appl_usage report to 
detemiine whether there is enough stale space to reclaim, 
or whether you should add more volumes to your library 
unit. For example, in an EO system with volumes averaging 
25% stale data, you must compact four volumes in order to 
get a single free volume (see Figure 1 3-2). If this rate is 
unacceptable in your environment, add more blank 
volumes. Refer to EDM Server Enor Messages for further 
details on what to do if automatic compaction fails. 
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Figure 13-2 



Freeing Volumes for Use 

Compaction Source Volumes Compaction Output Volumes 

100% Active (full) 



75% Active, 25% Stale 



Compacting Baseline 
Media 




□ 



[J] = Stale Data 
[ | = Active Data 
□ =Free 



1 Available Volum 



Compacting baseline volumes is similar to compacting staging 
volumes, but you can only compact baseline volumes manually. 
Compacting baseline volumes causes all currently active data 
associated with the volume to be copied to the current 
compaction volume associated with the baseline trail. New 
baseline compaction volumes are allocated as necessary. 

As a general goal, you should limit the number of active 
baseline volumes to the number of active staging volumes. If 
possible, you should also limit the number of active baseline 
volumes to the number of slots in your library units. This facili- 
tates recovery in the event of a site disaster by ensuring that all 
of the baseline media (to which active files are attached) will fit 
in your library units. 

To compact baseline volumes: 
1. Run dbreport baseline weekly and refer to the "pct_stal" 
column for baseline volumes. 
emc# dbreport baseline 
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2. Use emcompact to compact the iVmost stale optical disks 
or tapes. (In the case of optical disks, there are two 
volumes per disk.) The value of A ? varies, but it is at least 
the number of active baseline media minus the number of 
active staging media or slots in your library units, whichever 
is less. 

Therefore, if you have 55 active baseline media, 45 active 
staging media, and a 50-slot library unit, compact at 
minimum the ten most stale baseline media. 
This results in a set of compacted baseline volumes. Note 
that these volumes are not deallocated and available for use 
until all existing baseline-relative backups that reference 
them expire. 



Clearing Incomplete As part of nightly maintenance, the system runs the emscheck 

BltfHeS program via root's crontab to clear the incomplete bitfiles that 

accumulated in the client stores as a result of an interruption of 
service during a stage-out. 

For example, the following line in root's crontab runs 
emscheck every day at 12:30 a.m.: 

30 0 * * * /usr/epoch/bin/emscheck >/dev/null 2>&1 



Moving a Store tO Another To move client stores from one EDM server to another, do the 

EDM Server following: 

1. Use the emschs command to freeze the client store. 

emcl emschs alpha_all -2 

Store Name 
Freeze Store 



2. Use the ebcp command to relocate the entire contents of 
the store. Note that you must copy both die magnetic and 
staged out data. The following example copies all of the 
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files, including the files that are staged out, in the /alpha_all 
store on a system named "erne'' to the /alpha_new store on 
a system named "emc2." 
emcf cd /stores/alpha_all 

emel ebop -o . | rsh emc2 /usr/epoch/bin/ebcp 
-i /stores/alpha_new 

3. On the new server, emc2, use emsmks to add the store to 
the server configuration. 

emc2# emsmks alpha_new -p /stores/alpha_new -c alpha_new 

Directory /stores/alphajiew already exists, reuse [ y/nl ? y 
Store configuration data already exists, reusing, 
emsd is running, restarted..! OK] 

4. Unfreeze die store on the new server: 
emc2# emschs alpha_new -w 

5. Notify die client system of the store's new location. Note 
that in this case trail_l is the name of the previous staging 
trail. 

alpha* emstconf trail_l ------ emc2 : alpha_new 

6. Add the new migration tag on the new server; 
emc2# emschs alpha_new -t new_migration_tag 

7. Remove the old store from the original server: 
emc# emsrms alpha_all 



Gathering Migration Store Use die emsstat command to display network migration server 

StatlStiCS activity levels. The emsstat command gets its information by 

accessing statistics diat are kept in a shared memory segment 
used by all active EDM Migration server daemon (emsd) 
processes, or from a statistics file if emsd is not running. 

If you type emsstat without any arguments, it displays statistics 
representing server activity since the statistics were last cleared. 
If you use the -i option, emsstat displays die ongoing server 
activity, and, by default, updates the screen in 10 second 
intervals. 
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To reinitialize the statistics database enter the following 

commands: 

emc$ eroshalt 

emcS rm /usr/epoch/etc/mal/enisd_stats 
emcl ems start 

See the emsstat man page for further details. 



Checking a Network Use the emcheck command to check the EDM Migration client 

Client's Staging conngi ration. You must be superuser to run emcheck. If you 

Configuration l yP e the command without any arguments it checks the config- 

uration database, warns you of potential problems and corrects 
inconsistencies. See "Checking the Staging Configuration" on 
page 13-12 for more information. 



Troubleshooting HSM I-ISM depends on the interaction of several daemon processes. 

Most HSM problems are caused by the failure of one of these 
processes. The following checklist enumerates the steps to take 
to troubleshoot HSM problems. (Use the emlistd command to 
check whether any of the following processes are running.) 

□ Verify that the HSM file monitor daemons (emficad) are 
running. 

□ If you are unable to stage in files, verify that the stage-in 
daemons (emsid) are running. 

□ If demand or periodic staging fails, verify that at least one 
master daemon (emmasterd) is running. 

□ If die user-level commands (emstage, embsi, emchmod, 
and emls) are failing, verify that the HSM RPC daemon 
(emrpcd) is running. 

□ Look in the /var/adm/epoch/detail log for error message 
information. 
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RGStOritiy fl LOSt Or The procedures for restoring a lost or damaged staging volume 

DSITISgOd Staying VollJIIIC vary, depending on whether or not baseline backup is installed. 



If baseline backup is not enabled: 

1 . Use the dbreport volumes report to find the volids of the 
missing volume(s). (The volid is a 16-digit hexadecimal 
number.) For two-sided media, you need to get the volids 
of both sides. 

2. If the lost volume happens to be the current staging 
volume, the current compaction volume, or an active 
backup volume, you need to use em_new_volume as 
follows: 

emc# em_new_volume staging_trail_name 

3. Locate the files staged to the missing volumes by using 
emfindO): 

emc# emfind / \< -staged_to 0000111122223333 -o\ -stagedjto 0000111122223334 \) - 
print > /usr/tmp/f iles 

Note: If emfind encounters a pathname that is too long, it 
generates an error message. The pathname is not 
added to /usr/imp/files, and the subsequent restore 
are incomplete. Some manual intervention 
(descending into directories and rerunning emfind) 
is necessary in such cases. 

4. Delete die missing volumes from the database using 
evmrmvol: 

erac# /usr/epoch/bin/evmrmvol -v 0000111122223333 
emc# /usr/epoch/bin/evmrmvol -v 0000111122223334 

5. Restore necessary files: 

emct ebrestore -D server -c server -w workitem -d -f /usr/tmp/f iles 



Restoring a Lost or Damaged 
Staging Volume (No Baseline 
Backup) 
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Restoring a Lost or Damaged 
Staging Volume (Baseline 
Backup is Enabled) 



ic# /usr/epoch/bin/evmrmvol 
ic# /usr/epoch/bin/evmrmvol 



• ebrestore -D serv* 



If baseline backup is enabled, you can use ebcheck to restore a 
staging volume. The steps are as follows: 

1. Using dbreport volumes, obtain the IDs of the missing 
volume(s). For two-sided media, you need to get the IDs of 
both sides. 

2. Delete the missing volumes from the database using 
evmrmvol: 

-v 0000111122223333 

-v 0000111122223334 

3. If the missing volumes are baseline backup volumes, simply 
invalidate the pointers to the baseline volumes-. 

einc# ebcheck -a -i 

4. Otherwise, if the missing volumes are primary staging trail 
volumes, restore as many of the files as possible from the 
baselines: 

emc# ebcheck -a -i -bl -b2 

5. Restore any remaining files from the full and incremental 
backup volumes: 

enact ebcheck -a -rl -r2 > /usr/tmp/files 

6. If /usr/tmp/files is non-empty: 

server -w workitem -d -f /usr/tmp/files 



Restoring a LOSt Or This method uses baseline volumes as a temporary staging trail, 

Damaged Staging Trail which lets you bring the system back up much sooner. The 

procedure is very quick, and you can generate your new 
primary staging trail while the system is up and providing 
service: 

1. Delete each missing volume from the database as before. 

2. Make die baseline backup volumes also act as a copy of the 
primary staging trail: 

emc# ebcheck -a -i -cl -c2 
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3. Restore any remaining files from the full and incremental 
backup volumes: 

eracl ebcheck -a -rl -r2 > /usr/tmp/f iles 

4. If /usr/tmp/files is non-empty: 
emc# ebrestore 

5. Using restage, generate a new primary staging trail for each 
filesystem as appropriate: 

emc# restage -t trailname / \( -fstype nfs -prune \) \ -o -staged_to_trail 

baseline^ trail name 



Restoring a Lost or These steps restore a filesystem to its state as of its last backup, 

Damaged FileSyStem after a complete loss due to disk failure and the like. The steps 

assume the staging trails, backup catalogs, and the root 
filesystem all are still intact. 1 he steps are designed to avoid all 
accesses to the filesystem while it is being restored, whether 
local or remote, so that users do not see a filesystem that is only 
partially recovered. 

1. Create a new empty filesystem, the same size as the original 
one or larger: 

# mkfs -P vxfs -o inosize=512 /dev/rdsk/cA'tydZ 

2. Mount the filesystem to a temporary location (called 
/tmp_doc in the examples below): 

# mkdir /tmp_doc 

f mount -F vxfs /dev/oXtYdZ /tmp_doo 

3. If die filesystem was configured for HSM, you must now? 
configure the new filesystem for HSM. This step must be 
done before recovering any data, or staged out files are not 
recovered correctly. 

Use the EDM HSM configuration interface, just as if you 
were configuring a filesystem for the first time. The 
filesystem may be assigned to the same staging trail as the 
original, or to a different staging trail; it makes no 
difference. 
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A. Using the EDM Restore interface, restore the last backup of 
the filesystem you lost (called doc here) onto the new 
filesystem (mounted here at /tmp_doc). 
Mark everything in the filesystem except for die .-EPOCH-, 
and lost+founcl directories. 

5. Change to die /tmp_doc/doc directory, and move every- 
thing to /tmp_doc. 

# cd /tmp_doc/doo 

# iv * /tmp_doc 

# cd . . 

# nadir doc 

Be sure to check for files or directories whose names begin 
with "." since they are not moved by the mv command. The 
rmdir command fails with "Directory not empty" in such 
cases. The Is -a command lists these files; they have to be 
moved manually 

6. If die new filesystem (,/tmp_doc) was configured for HSM. 
remove it now from the staging configuration database. 
There is no need for this configuration now, since the 
original filesystem (/doc) should still be in the staging 
configuration database. 

7. Umount the filesystem from its temporary mount point, and 
remount it under its real name. 

This example assumes that the same physical device 
address is being used for the new /doc (the usual case if a 
new disk was brought in to replace a failed one). If the 
device address is now different, be sure to update the 
/etc/vfstab entry for die filesystem. 

# cd / 

# umount /tmp_doc 

# rmdir /tatp_doc 

# mount /doc 
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Start of Backup 
and Related 
Processing 



The EDM Backup software automatically initiates backups, 
processes catalogs, and generates back-up reports. You can also 
initiate these functions manually, or edit the crontab file to 
change how these functions occur automatically. This chapter 
contains the following topics: 

• Backup Processing 

• Catalog Processing 
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Backup Processing Following are methods of initiating backup processing with 

EDM Backup: 

• by using die Backup Activity Wizard 

• automatically from crontab (see page 14-3) 

• manually from command line (see page 14-7) 

The Backup Activity Wizard enables you to start new, queued, 
or failed backups, stop running backups, or manage the backup 
queue. You access this wizard from the Main window of the 
EDM GUI. 

Note: You must have root privileges or be an EDM 

Backup Administrator to use the Backup Activity 
Wizard. 

For automatic processing, EDM Backup uses the crontab facility 
to issue the ebbackup command at a particular time each night 
to start backups. Tire command specifies a backup schedule 
template, which contains scheduling parameters. You can create 
additional crontab entries (using the Backup Configuration 
Wizard, by editing the file, or from the Backup Configuration 
window of die EDM GUI) for any schedule templates that you 
add. You can optionally specify a particular work group or 
work item, backup level, or specific day with die ebbackup 
command, but you would typically use the Backup Configu- 
ration Wizard or the backup template. 

To start network backups manually, you can issue the 
ebbackup command from the command line. Again, you can 
choose to specify a backup schedule template, but you would 
more typically specify a particular work group or work item, 
backup level, or specific day when starting backups from the 
command line. 
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To start Symmelrix Connect backups manually after successful 
client configuration, issue the eb_dc_backup workjtem 
_base_name command. Refer to the EMC Data Manager 
Symmetrix Connect Use}- Guide for more information on starting 
these types of backups and related processes. 

Note: However you initiate backups, make sure your 
clients are configured and that you have labeled 
your media and inserted that media into the 
appropriate library unit. 

For additional information, refer to "Scheduling" on page 3-4. 

The following sections describe starting backups in the crontab 
file or manually from die command line. 



Backup Activity Wizard As mentioned above, the Backup Activity Wizard enables you to 

start new, queued, or failed backups, stop running backups, or 
manage die backup queue. You access this wizard from the 
Main window of the EDM GUI. 

Click this icon in the Main Window to start the 
Backup Activity Wizard. 



In the wizard panels, you select a backup operation, select the 
objects on which you want to operate, choose backup options, 
and confirm your actions. You can then monitor the progress of 
the backup operation that you initiated in the Main window. 

Refer to EDM online help for more information. 



Automatic Nightly Processing You can use one of the following methods to configure the 

crontab facility to schedule automatic backups for each defined 
schedule template in the configuration file: 

• Backup Configuration Wizard (which you access from the 
EDM Main window toolbar) 
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• Backup Configuration window (refer to EDM online help 
for more information) 

• CLI 

By default, the backup schedule template runs automatically at 
6:00 p.m. every night. 

Note: An error message appears if scheduling a backup 
via cron is unsuccessful. 

Each line in root's crontab file has several fields of information. 
Figure 14-1 shows the format of the crontab entry that invokes 
the ebbackup program. 



Minute J 

Hour I 

Day of Month I 

Month of Year | 

Days of Week I 

Command to Run I 

Arguments) 

You can edit root's crontab file t/var/spool/cron/crontabs/root) 
to change when to begin backups. If you add any backup 
schedule templates, you edit root's crontab file to specify when 
to begin backups. 

You can also schedule a backup in the crontab file within the 
Backup Configuration window of the EDM GUI. In the window, 
you select a work group for backup and the time that the 
backup is to occur. You can also indicate whether you want to 
schedule a failed backup, or use new media for a backup. (For 
more information, refer to Chapter 2 of this manual, EDM 
online help, and the ebbackup man page.) 



Figure 14-1 



Root's Crontab File Entries 



ebbackup backup-template (s) 
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After you edit the file, die backups occur automatically. At the 
specified time each day, root's crontab file invokes the 
ebbackup command, which starts overall backup processing. 
Edit the file again only when you want to change the nightly 
backup run time. 

Figure 14-2 shows a sample crontab entry, which starts a 
backup using the schedule template named "cdr-all." 

The template "cdr-all" specifies the work groups to back up and 
the trailset to write the backups to. AsterisksC) represent 
unspecified fields. 



A Sample Crontab File Entry 



Command to Run 1 

Schedule Template Name 

The sample crontab entry in Figure 14-2 indicates the following: 

• the Minute field specifies to start the backup 30 minutes 
after die hour. 

• the 1 lour field specifies the hour at which to start the 
backup. In this example, the backup will start at 10:30 p.m. 
The length of time ebbackup runs depends on the length 
of die shift as defined in the backup template or when all 
scheduled backups finish — whichever occurs first. 

• the Day of Month field indicates all days of the month (*). 

• the Month of Year field indicates all months (*). 

• the Days of Week field indicates all days of the week (*). 



30 22 * 



ebbackup cdr-all 



Minute _J 
Hour 




Day of Month 
Month of Year 
Days of Week 
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• the Command to Rim field specifies the command 
(ebbackup). 

• the Schedule Template Name field specifies the backup 
schedule template on which to run the backup (cdr-all). 

The ebbackup command starts backups For a backup schedule 
template. By default, a backup schedule template specifies 
automatic scheduling of backups for all of the work items 
affected by it. When EDM Backup starts it uses the rotation 
period, the rotation scheme, and the backup shifts that are 
specified in the named schedule template to determine what 
work items to back up during that backup session. 

EDM Backup manages the backups, perfomiing one full backup 
(level 0) for each work item each rotation period, and 
scheduling level 9 backups on the remaining days in the 
rotation period. 

EDM Backup's ability to automatically balance the backup work 
load frees you from the task of manually assigning each client 
to a backup schedule. Automatic scheduling also adjusts to 
clients that are down during the scheduled backup. 

You can also specify custom scheduling for the backup. In 
custom scheduling, the backup schedule template explicitly 
defines the work items and die days on which they are 
scheduled for backup. You can specify the custom schedule for 
the template within the Backup Configuration Wizard or die 
Backup Configuration window of the EDM GUI. 

Backups that you schedule by using the custom schedule 
directives in the backup template are initiated using root's 
crontab file to begin processing for the template, just as for 
automatic scheduling. 
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Note: If a client is unavailable on its scheduled backup 
day, the backup does not automatically reschedule 
the backup to another day as auto scheduling does. 

It is also possible to use the ebbackup command to directly 
specify particular backup levels on certain days for certain work 
groups or work items. This alternative command format is 
described in the next section. 



Command Line Processing You can choose to initiate all backups by using the cron facility 

or command line. 

The ebbackup command enables you to specify the level of 
backup, work group, work item, priority, and/or trailset to use 
for a backup. You can use the ebbackup switches in 
combination with the crontab facility to schedule a command 
for a certain time each day to schedule each backup. 

The ebbackup command options are useful when you want to 
schedule a specific backup. For example, you may want to 
force an immediate full (level 0) backup for a particular client's 
work item before performing an operating system upgrade on 
that client. You can also use the command line to schedule or 
reschedule backups that have failed. Refer to the man pages for 
ebbackup for details about the available options. 

When you specify a backup from the command line, this 
backup overrules any backups scheduled by automatic or 
custom scheduling. 

Note: To run a command line backup for a particular 
backup level, you must first define that level in a 
trailset. 

The following examples show how to use the command line to 
backup a work group, a work item, and an HSM work item. For 
more information see the ebbackup man page. 

The command line in Figure 14-3 starts level 9 backups for the 
clients in the work group named "cad." 
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Figure 14-3 



Backing Up a Work Group 



# ebbackup -1 9 -g cad cdr 



ebbackup Command 
Backup Level Switch 
Backup Level 
Work Group Switch 
Work Group Name 



Backup Schedule Template Name 

The command line in Figure 14-4 starts level 0 backups for the 
work item named "cad-all." 



# ebbackup -1 0 -i cad-all cdr-all 



ebbackup Command 
Backup Level Switch 
Backup Level 
Work Item Switch 
Work Item Name 
Backup Schedule Template Name 



The command line in Figure 14-5 starts baseline backups for the 
HSM work item "arias!:/" to the "off site 2" traflset. 



Figure 14-4 



Backup up a Work Item 
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Figure 14-5 



Backing Up an HSM Work Item to a Trailset 
ebbackup -1 Bl -i atlasl:/ -t "off site 2" f ileserver-i 



ebbackup Command 
Backup Level Switch 
Backup Level 
Work Item Switch 
Work Item Name 
Trail Switch 
Trailset Name 
Backup Schedule Template 



Catalog Processing When a backup completes, the raw data for the associated 

catalog exists on the EDM Backup server. The catalog daemon 
(ebeatalogd) must process the raw catalog before the restore 
process in the EDM Restore window or the command 
ebrestore can use it. You can have catalog processing 
performed concurrently with backups, or you can schedule 
catalog processing for a later time so that this task does not 
slow down client backups. 

Normally, the /etc/rc3.d/s30ebs script starts ebeatalogd at boot 
time. 

To exercise greater control over the catalog processing 
schedule, you can start and stop ebeatalogd manually, or you 
can control it automatically via root's crontab file. To start 
catalog processing, run ebeatalogd without arguments. The 
catalog daemon places itself in the background when it ams, 
and terminates if another catalog daemon is already running. To 
stop catalog processing, run ebeatalogd with the -halt option. 

Figure 14-6 shows a crontab entiy that starts catalog processing 
at 6:30 AM each day, which is after the site's backup shift ends. 
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Figure 14-6 Starting Catalog Processing from Crontab 

30 06 * * * /usr/epoch/EB/config/daemon_startup -ebcataiogd 

Figure 14-7 shows a crontab entry that stops catalog processing 
an hour before the backup shift begins again at 10:30 p.m., the 
site specifies halting catalog processing at 9:30 p.m. 

Figure 14-7 Halting Catalog Processing from Crontab 

30 21 * * * ebcataiogd -halt 
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Message 
Logging 



The EDM Backup and HSM software maintains a message 
logging system that uses both the system log daemon, syslogd, 
and circular logs to record significant events. These messages 
can be written to log files or to the system console. The 
configuration file (/usr/syslog.conf) determines the error 
conditions that are logged and where the messages are sent. 

This chapter contains the following sections: 

• Message Logging Features 

• Syslog Message Files 

• Circular Log Files 

• Log Message Format 

• Default syslog Configuration File 
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Message Logging The message logging system offers the following features: 

Features . Automatically creates log files: 

During system installation several message log files are 
created automatically. These files are specified in the 
/etc/syslog.conf file, and described in "Default syslog 
Configuration File'' on page 1 5-6. 

• Uses cron to mail messages to system administrators: 
For sites with a mail facility, cron starts a script that mails 
log messages which describe the system activities 
(anomalies only) for die previous 24-hour period to the 
system administrator. (See "Running Procedures Automati- 
cally via Cron" on page 2-6.) 

• Groups files into logical categories: 

The syslogd sends log messages to specific log files 
depending on the type of message. Because EDM Backup 
software groups messages into separate log files, you can 
choose to look at the log file that is most appropriate for 
the task at hand. For example, all messages that describe 
maintenance activities are sent to one particular log file, 
while messages that show error audit trails are sent to 
another. 

• Monitors interaction of EDM subsystems: 

Subsystem messages work together to give a complete view 
of system activity. This means that when an event occurs, 
all affected subsystems log a message. By looking at 
messages that are sent from different subsystems, you can 
see the relationship of each subsystem's activity. 



Syslog Message Files All syslog messages are written to log files that reside in 

/var/adm/epoch. 
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Note: All of the log files, except for the daily log, are 

rotated or archived in /usr/epoch/adm. where they 
remain for four weeks. 




The messages in these files enable you to determine the cause 
of a system problem. The log files are named the following: 




• concise 




• daily 




• detail 




• mntfaulf 




• lu_hardware 




Table 15-1 explains when to look at each message file: 


Table 15-1 


When to Look at the Sysiog Message Files 


If you want to: 


Look at this file: 


determine quickly if any sysi 
emptv, you know the system 
file daily. 


:em problems have occurred. If the file is /var/adm/epoch/concise 
i is operating properly. You should view this 


see system problems for the 
the concise log. 


past 24 hours. The daily log is a subset of /var/adm/epoch/daily 



check the debug log. Debugging must be turned on according to the /var/adm/epoch/debug 
directions in the /etc/syslog.conf file. Hits file is primarily for use by 
Customer Service personnel. 



see additional information about the errors that appear in the concise /var/adm/epoch/detail 
log. 

view a list of volume requests (which require operator assistance) and /var/adm/epoch/mntfault 
the audit trail for volume allocation and erasure. You can forward these 
messages to other systems and/or to tire system console for monitoring. 

see additional information about hardware errors that appear in the /var/adm/epoch/lu_hardware 
detail log 
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Circular Log Files You can configure message logging to bypass the standard 

system logs and write messages to circular logs. Circular logs 
are located in a central directory or in application-specific 
directories. The following directories contain circular logs: 

• /usr/epoch/ad nVci rcular 

• /usr/cpoch/eic/subdirectory 

The names of die circular log files that are located in the central 
directory /usr/epoch/adm/circular are based on the daemon 
name. For example, the name of die circular log for the 
volume management erase daemon is vm.erd.log. 

Volume management maintains its circular log in 
/usr/epoch/etc/vm. This provides the system administrator with 
access to all VM-related files in one directory. For this same 
reason, circular logs for each Library Manager reside in 
individual subdirectories of /usr/epoch/etc/lm. 

Circular logs that reside in VM and LM directories are named 
clog (for circular log). 

You can use the fuser command to show all processes that 
have a given file open. For example: 

• fuser -f /usr/epoch/etc/lm/hp_mf_sa/clog 



Log File Rotation and Archival If you are using the migration option, the concise and mount 
fault logs are rotated in /usr/ epoch/ adm. 

The detail and debug logs are archived in /usr/epoch/adm for 

one year in systems on which EDM Migration is installed. The 

logs are archived in year-month subdirectories as shown in the 

following examples: 

/usr/epoch/adm/ 1999-10 

/usr/epoch/adra/1999-11 

/usr/epoch/adm/1999-12 
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Within each subdirectory, the archived logs are written to a 
detail. ifey file. For example, the following file contains the 
detail log for December 23, 1999- 
/usr/epoch/adrn/1 999-12 /detail. 23 

If more than one rotation occurs on a single day, another suffix 
is added as shown in the following examples: 
/usr/epoch/adm/1999-l2/detai 1.23.0 
/usr/epoch/adm/1999-12/detail .23.1 
/usr/epoch/adm/1999-12/detail.23.2 

The highest number suffix (detail.23.2 in this example) 
represents the most recent log. 



Log Message Format Each i og message provides the following information: 

• date/time string 

• host name that identifies the name of the system on which 
the event occurred 

• name that identifies the process that generated die message. 

• optional user ID (usually supplied if an interactive program 
is logging the message). Many subsystems can only be run 
by root and therefore omit this field. 

• process ID number that appears between square brackets. 
(Kernel messages, which are identified by the prefix 
vmunix, do not have this field.) 

• optional layer name, sometimes prefixed by a subsystem 
name, that provides EMC customer service with additional 
information 

• message number that uniquely identifies the message. 
Using the prefix mat immediately precedes the pound sign 
{*). This prefix is either the process or layer name, 
depending on the message. 
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host procesi 



• brief free-form description of die condition. 

To summarize, each log message conforms to the following 
syntax: 

user> pid <<subsystem:> layer:> message § — mess a 
Figure 15-1 lists some sample log messages: 



Sample Log Message 



Dec 11 03:11:18 pooh backup by root [505] #456 - - Backup starting 
date/time string host process user pid message # message 



Ian 28 11:31:07 pooh VM as root [ 33] ELM: VM : #101 - - VM Starti: 
date/time siring host process subsys:layer message* message 



Default syslog 
Configuration File 



A default, sample /etc/syslog.conf file is provided when you 
install the software. It contains the following lines in which the 
first column specifies the error condition and the second 
column specifies the file to which the error is logged. 



r;lo. 



alS.e 



r;local5.err 



kern . info; local 5 . : 
* .debug 



/var/adm/ epoch /concise 
/var/ a dm/epoch/daily 
/var/adm/ epoch/mnt fault 
/var/adm/ epoch /detail 
/var/adm/ epoch /debug 



Note: The concise and daily logs receive the same 
messages. The messages in the daily log are 
truncated each day. 
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I and Log Files 



When you run a backup or restore, EDM Backup saves infor- 
mation that you can then access through log files or reports. 
You can review this information to verify mat your applications 
are executing correctly. 

Reports are available online in the Backup Report window of 
the EDM GUI. You can execute reports on successful, failed, 
active, and queued backups on your local EDM and on multiple 
EDMs which are set up in a domain. This window enables you 
to create, modify, and print backup reports to look at key areas, 
such as performance within specified time periods, work items 
with poor performance, or failed work items. (For more infor- 
mation see the online help for the EDM Backup Report 
window.) 

Some reports are generated automatically. You can run the 
ebreport commands for other reports from the command line 
or insert them into your crontab file for automatic processing. 
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This chapter describes the followi 
information, refer to the appropri 

• Report and Log Usage » 

• Executing Reports from 
the EDM G UI 

• Report and Log 
Summaries 

• Backup Reports 

• Backup Media Reports 

• Backup Duplicate Reports 

• Backup Histoiy Reports 



tg reports and logs (for more 
ate man page). 

Backup Disaster Reports 
Backup Baseline Reports 

Backup Completion 
Reports 

Backup Failure Reports 
Backup Coverage Reports 
Volume Reports 
Log Files 



Report and Log Usage You receive logs automatically, whereas you need to request 

most reports. After a backup or restore finishes, you receive an 
e-mail message that indicates whether the operation was 
successful. (You can also monitor backups in progress and then 
generate reports via the EDM graphical user interface (GUI); 
refer to "Executing Reports from the EDM GUI" on page 16-3). 

If the backup or restore is successful, you do not have to review- 
any of the logs and reports. However, these reports include 
information about your system thai you may want to know or 
monitor. 

If your backup fails, you receive an email message that tells you 
the backup failed. You should then look at the backups Jog file, 
which contains clues as to why the backup failed. If you see a 
message such as "Client not available," a client may have gone 
down during the backup or your system may have a 
network problem. You should review the backups.log file on 
the client mat failed to see what information that file has on the 
backup. 



EDM Software Reference 



16-3 



Executing Reports from the EDM GUI 



A minimal disaster report is generated automatically each time 
the LOCA L_DATABA SE work item completes. You need the 
information in this report to perform a disaster recovery. The 
disaster report, by default, is mailed to the backup adminis- 
trators, printed, and saved to disk. 

Note: Refer to Chapter 1 9 "Being Prepared for a System 
Disaster". 

Regardless of whether your backup succeeded or failed, you 
may want to review the backup coverage reports. Each report 
displays information about the fiJesystems that were not backed 
up. It displays the client names, the size of each filesystem, the 
name of each filesystem, and a summary line with grand totals 
for each column of information. 



ExeClltifig RepOrtS frOm You can execute reports in the EDM graphical user interface 

the EDM GUI (GUI). These reports can be reports for a local EDM or domain 

reports for a group of EDMs. The online help for the Backup 
Report window explains how to set up and use a domain, and 
lists the limitations of domain reporting (for example, that a 
domain cannot span a firewall or reconcile time differences on 
machines). 

Objects in the Main window such as the EDM server, a client, or 
a work item, are colored to designate a successful, failed, en- 
queued backup. 

You can configure, run, and print backup reports on specific 
areas such as failed work items or work items with poor perfor- 
mance. 

Click on this icon in the Main window toolbar to access 
the backup report module. 

For more information about active backup reporting, 
refer to EDM online help, "Backup Report Overview." 
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Report and Log You can initiate reports manually by using the following 

Summaries commands, or you can add them to your crontab file for 

automatic generation. For more information on a specific report, 

refer to the man page for the report. 

Table "16-1 lists the reports that EDM Backup generates. 



EDM Backup Reports 



Report Name 



Command 



Backup 
Backup media 
Backup duplicate 
Backup history 

Backup disaster 

Backup baseline 

Backup completion 
Backup failure 
Backup coverage 



ebreport backup 
ebreport media 
ebreport duplicate 
ebreport history 

ebreport disaster 

ebreport baseline 
none 1 

ebreport coverage 



Contains a summary of the backup activity performed 
by the server. 

Contains information about the media to which EDM 
Backup wrote backup data. 



about media duplication 
(Refer to Chapter 9 "Media Duplic 



Displays information about the backups performed on 
the server. Use the command options to display specific 
details. 

Contains a combination of other reports including a list 
of media for each backup trail , a detailed record of 
client backups, copies of the key configuration-file 
settings, and a history. 

On 1 1SM systems, contains a summary of baseline 
backup activity as reflected in the saveset database. 

Confirms backup operations. 

Notifies you if your backup fails. 

Displays information about which filesystems were 
backed up and which filesystems EDM Backup is not 
backing up. 



1. There is no command available since the report is generated automatically. 
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For detailed descriptions, see the following sections in this 
chapter. 

Note: The examples in this chapter are from different 

servers and different configurations and times. They 
cannot be compared to each other. 

Table 26-2 lists the log files that are generated by EDM Backup 
and located in /usr/epoch/EB/log on the server. For detailed 
descriptions, see "Log Files" on page 16-35- 



Table 16-2 


EDM Backup Log Files 


Report Name 


Information 


backups.log file 


Displays an audit trail of backup-related activities on the seiver and 


the client. 


recoveries.log file 


Displays ebrestore operations on the server and the client. 


ebcat.log file 


Contains catalog processing startup and shutdown times. 


Server log file (template level) 


Displays backup information about activities for a single backup 




schedule (template). 



BSCklip R6p0rtS The ebreport backup command presents a summary of EDM 

Backup activity. It reports die status of the most recent backup 
run (unless the -recent or -since option is given). The work 
items are grouped by template (backup schedule) name, and 
trailset (media set). For a given work item name, the most 
recent backup is shown first. 
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Run ebreport backup ever)- day to verify that all of the 
scheduled backups completed. 



ebreport backup Command Information 



Option 



Argument Definition 



-client clientname 



-level levehvumber 



-since date \time] 
-until date 



the client 
backup history yoi 
) display. 



Displays only the specified client's work 
items thai are backed up to the backup 
server. 

When the client name used is semername, it 
displays backups of server filesystems and 
databases, but does not display backups of 
filesystems or databases on remote clients. 

levelnumber is a level from 0 Displays only the backups of the specified 
to 9, a range of levels (for levels (unless you use the other options to 
example, 0-8), or Bl or B2, limit the report coverage), 
for which you want to display 
backup history. 

Displays all of the work items that were 
backed up by EDM Backup, from the second 
most recent level 0 backup to the present. 



date is the date in the for 
mmjddlyy. time (optic 
the time in the format 
{hb-jnmbss]]. 



Limits the backup report to a range of dates. 
1) is Use -since to show the backups that 

occurred on or alter a particular date or use - 
until to display the backup history that 
occurred on or up to a particular date. 
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ebreport backup Command Information (Continued) 



Argument Definition 



-trailset primary] alternate 



-template n 



-workltem name 



name is the template 
(schedule) from which 
backups are selected. If "*" is 
used for name all templates 
are selected (the default). 
Note that "* " must be quoted 
on the command line 



Displays only the work items thai 
backed up by a primary or altera 
media (trailset). 

Selects only the backups that wei 
for the named template. 



name\s the named work it 
for which backups were 
created. If "*" is used for 



selected (the default). Note 
that '"* " must be quoted on 
the command line. 



You might see database work items with the same name except 
for an added suffix in the form ":stripe_n_of_/n." This occurs 
if the backups were striped. If the backups were striped, you 
also see a suffix on the template names. For example: 

hamster :master+: sybase: stripe_l of 2. 
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Figure 1 6-1 shows a sample backup report. 


Figure 16-1 


EDM Backup Backup Report 




i server Lesla al SepL 28 09:09:09 1996 




ernate: Trailset name 


ebfs_bt_1, Primary: ebfs_ts_1 


Work iter, name Level 


-tart time Time used Backup Files\ bad Size Catalog 


ebfE^wH C 1C/0 
ebfs>0 0 lc/0 


Cf:4C-:ji C : _ : 3 0 Conpletcd 33\ 0 -330.0 MB Complete 
/98 06:43:32 0:11:40 Completed 37\ 0 401.0 MB Complete 
/98 06:43:32 0:12:10 Completed 4 6\ 0 415.0 MB Complete 
/98 06:43:32 0:11:30 Completed 29\ 0 393.0 HB Complete 


Backup Level 


1 1 

Backup States Catalog States 

Table 16-4 describes the different backup states that can appear 
in the Backup Report. 


Table 16-4 


Backup States 


State 


Description 


Starred 


Backup is underway tor it was interrupted before finishing) 


Partial 


Backup was manually shut down before finishing 


Incomplete 


An en - or caused the backup to fail 


Completed 


Backup finished successfully 


Unsuccessful 


Backup completed with errors 


Failed 


No files were backed up, possibly due to a misconfigured work item 


Timed-out 


Client connection timed-out 
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Table 16-5 describes the different catalog states that can appear 
in the Backup Report. 



Table 16-5 


Status of Catalog Processing 


State 


Description 


Partial 


Catalog is being created (or it was interrupted before finishing) 


Unsoned 


Intermediate state in the post processing of the catalog. 


Sorted 


Intermediate state in the post processing of the catalog. 


Complete 


Post processing completed 


Delta 


Catalog was reduced to a collection of changes against the catalog of 
the subsequent backup 


Expired 


Online catalog for the backup was deleted 
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Backup Media Reports 


You can use the ebreport media command to display a list of 


all volumes to which EDM Backup wrote backup data. Use one 




of the options in Table 16-6 to limit the report size. 


Table 16-6 


ebreport media Command Information 



Option Description 



Displays the volumes thai EDM Backup is currently using to write backup data. 
Displays the volumes that are marked for offsite storage. 

Displays the volumes that are marked as onsite (usually after their status was changed 
from offsite to onsite). 

Displays the volumes that the named template uses. 

Displays the volumes that the named media set (trailset) uses. If -template is used, only 
"Primary" or "Alternate" (both of which are defined in the Backup Configuration 
window), can be specified. 

Displays the volumes that the named trail uses within a trailset, 

Displays a list of orphaned volumes. This cannot be combined with any other command 
line option. 

Prevents the baseline media report from being generated on an EDM with the 11 SM 
option. This report is never displayed on a system without 1-1 SM. 

Displays command line options for ebreport media. 



A media rotation is the collection of volumes that a single 
backup schedule template writes to a particular trailset (media 
set) and trail during a single scheduled rotation period. 

Volumes are grouped into media rotations. The media report 
contains one section for each schedule template, trail, and 
trailset. The report lists within each section the volumes for 
each media rotation with the date, rotation ID, number of 
backups, and whether media duplication was used. 



-active 
-offsite 
-onsite 

-template name 
-trailset name 

-trail name 
-orphans 

-no_baselines 

-help 
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Figure 16-2 shows a sample report that ebreport media 
generates: 



Figure 16-2 EDM Backup Media Report 

Summary of all media, listed by media rotation groups 

Rotations for Template "usr_bin", Trail "usr_bin_DLT". Primary Trailset 

09/30/1998 12:54:42 Rotation 1D:4CD84987.F6BECF8D.00000200.54028F30, 4 backups 

Media duplication used on 1 copy 
*Orig Vol: 60D84A317OQ94B3E (BNY574), Seq * 000024 in TLU: at_dlt 3264_0, media: DLT tape 
Dup Vol: 73D8745B3E0384A5 (BDE133), Sec] *: 000028 in TLU: at_dlt3264_t), media: DL'l'tape 
Duplication State: Done, Successful, Duplication Date 05/08/1999 16:06:04 
Descriptions 

Section Header 

Rotations for Template w usr_bin", Trail "usr_bin_DLT", Primary- 
Shows Template Name, Trail Name, and Trailset. 

Rotation Header 

09/30/1998 12:54:42 Rotation 1D:4CD84987.F6BECF8D.()0000200.54028F30, 4 backups 

Media duplication used on l copy- 
Shows Backup Date and Time, Rotation ID, Number of Backups on Media, Use of Media Duplication. 

Volume Entries 

*Orig Vol: 60D84A1170094B3E (BNY574), Seq 000024 in TLU: at_dlt3264_Q, media: DLT tape 
Dup Vol: 73D8745B3E0384A5 (BDE133), Seq #: 000028 in TLU: at_dlt 3264_0, media: DLT tape 
Shows Asterisk for most recent volume in the rotation, Blank for all others. 

Then Original or Duplicate, Volume ID, (Barcode), Volume Sequence Number, TLU Type, and Media Type. 
Duplication information follows with Duplicate Volume ID, (Barcode), Volume Sequence Number, 
TLU Type, Media Type. 

The Duplication State, Duplication Date and Time follow. 
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Backup Duplicate RepOrtS The ebreport duplicate command displays a list of the original 
and duplicate volumes that are currently allocated to Epoch- 
Backup. These volumes are grouped into media rotations. 
Media rotations in the report are grouped by template, trailset, 
and trail. 

The first line in the report provides the status for the entire 
rotation; one or more lines follow that show the volumes 
allocated to the rotation. The rotation status line contains the 
time that the rotation was created, the rotation ID, the number 
of partial or complete backups written to the rotation, whether 
media duplication is enabled for this rotation, and if so, how 
many duplicates were made. For each original volume the 
following duplication information appears: duplication state of 
the volume (Scheduled, Done, etc.), whether the duplication is 
up to date, duplication status (Empty or Old), and mode of 
duplication. 

Information for each original volume in the report includes the 
16-digit volume ID, volume barcode in parentheses, volume 
sequence number, library unit in which the volume resides, and 
media type (e.g., DLT or EO). A "*" precedes the last original 
volume that was allocated to the rotation. 

If the original volume has an allocated duplicate volume, the 
line for each duplicate volume includes the same information as 
that for the original volume. If a duplicate volume exists, the 
display may include the total tape padding blocks that were 
duplicated for the last duplication, duplication start and end 
times, total duplication time, and duplicate expiration date. 

Note: Duplicate volumes that were created before this 

release of the EDM software may not display all of 
this information. 
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Duplicate Command Options 


Table 16-7 lists the ebreport duplicate command options and 
related information. 


Table 16-7 


ebreport duplicate Command Information 


Option 


Argument Definition 


Description 






Lists only the volumes that were last 
allocated to each active rotation. Also lists 
die date and time the trail was last 


-offsite 




Lists only the volumes that are marked 
for offsite storage. 


-since date 


date is the date for 
which you wish to view 
duplication history. 


Displays only those volumes for which 
duplications were attempted on or after 
the specified date. 


-template template name 


templatename is the 
backup template for 
which you want to 
display duplication 
history. 


Displays only the volumes that the given 
template uses. If this option is not 
supplied or if the given template is "*", all 
templates appear in the report. 


trail trailname 


trailname is the backup 
trail for which you want 
to view duplication 
history. 


Lists only the volumes that the given trail 
uses within a trailset. If this option is not 
supplied or if the given trail is all 
trails appear in the report. 


-trailset trailset name 


trailset name is the 
trailset for which you 
want to display 
duplication history. 


Displays only the volumes that the given 
trailset uses. If you use -template, you 
can specify only "primary" or "alternate;" 
otherwise, you can specify any valid 
trailset name. If this option is not 
supplied or if the given trailset is "*", all 
trailsets appear in the report. 
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Sample Backup Duplicate 
Report 



Figure 16-3 shows a sample report using the ebreport 
duplicate command: 



edm~ ebreport duplicate 



Figure 16-3 



EDM Backup Duplicate Report 



edm# ebreport duplicate 

Rotations for Template "usr_bin", Trail "usr_bin_DLT" , Primary Trailset 

09/15/1998 09:46:51 Rotation ID: A1D7 F9BD . 71812B77 . 00000200 . F206F11B, 104 
backups 

Media duplication used on 1 copy- 
Duplication State: Done, Old, Mode: New 

*Orig Vol: A1D7F9BD71812B77 (BDE098) Seq. #: 000025 in TLU: at_dit_3264_0, 
media: DLT tape 

Dup Vol: 40D81EE7477F8BDA (BDE146) Seq. #: 000017 in TLU : at_dlt_3264_0 , media: 
DLT tape 

Total Blocks: 34902B Start Time: 09/22/1998 10:54:26 End Time: 09/22/1998 
13:06:21 

Duration: 001 Hrs. 31 Min., Duplicate Expiration Date: 12/17/1998 

09/30/1998 12:57:57 Rotation ID: 65D84 98A. FD4DC69B .00000200. 540819 F4, 2 backups 
Media duplication used on 1 copy 
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BaCklip HiStOry RepOrtS The ebreport history command displays reports about die 
backups that an EDM Backup server and its clients perform. 
The top line of each report lists the name of the EDM Backup 
server and the report creation date. Under this line, EDM 
Backup lists each backup template (schedule) that it backed up, 
and for each backup template it lists the work items that the 
template backed up. 

For each work item, the report lists the history of backups, one 
line per backup, with the most recent backups first. The line for 
each backup includes the time that the backup occurred, the 
backup level, the backup ID, backup status, the number of files 
or directories backed up, the backup expiration date, and 
backup recovery status. (If a backup cannot be recovered, a 
"NO" appears in die Rcvr field of the history report, which 
implies that catalog processing needs to be done for that 
backup.) 

If you run the command without any options, the history report 
can be large. You can use several options to restrict the scope of 
the report. Use the command options singly or in conjunction 
with one another to select a restricted set of backups on which 
to report. The next sections describe the options to the 
ebreport history command. 
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History Command Options 


Table 16-8 lists the ebreport history command options and 
describes the information that is available through the 
command. 


Table 16-8 


ebreport history Command Information 


Option 


Argument Definition 


Description 


-client clientname 


clientname is the client 
whose backup history 
you want to display. 


Displays all of a client's work items that 
are backed up to the EDM Backup server. 


-workitem -workitemname 
or -item workitemname 


workitemname is the 
client's work item for 
which you want to 
display backup history. 


Displays a single work item's most recent 
backup history. 


-template templateuame 


templatename is the 
backup template for 
which you want to 
display backup history. 


Displays all of the client work items that 
were backed up by the backup template 
(schedule). 


-since date [time] 
-until date 


date is the date in the 
formal mmlddlyy. time 
(optional) is the time in 
the format \hh:mm[:ss]}. 


Limits the backup history display to a 
range of dates, Use -since to show the 
backups thai occurred on or after a 
particular date or use -until to display the 
backup history that occurred on or up to 
a particular date. 






Displays the work items that were backed 
up by a primary or alternate set of media 
(trailset). 


-level levebtumber 


level-number is a level 
from 0 to 9, or a range of 
levels (for example, 0-8), 
for which you want to 
display backup history. 


Displays all backups of the specified 
levels unless you use the other options to 
limit the report coverage. 


-recent 




Displays all of the work items that were 
backed up by EDM Backup, from the 
second most recent level 0 backup to the 
present. This report lists the standard 
ebreport history information. 



EDM Software Reference 



16-17 

Backup History Reports 



ebreport history Command Information (Continued) 



-volumes or -media 



-recover_size 



-seconds 
-ebimport 



-help 

-nopartials 



Argument Definition Description 



Displays the media volume names thai 
are required to restore these backups. 

Displays the amount of* disk space that is 
required to restore each listed backup. 
'Hie size is listed in KB, MB, GB, or TB as 
appropriate. 

Displays seconds in lime reported. 

Displays only backups that require 
ebimport(lm) before backup can be 
restored. 

Displays all expire times (catalog, 
saveset, media), not just the one closest 
to expiration. 

Displays backup completeness mode for 
each listed backup saveset. 

Displays the EBFS directory ID for each 
listed backup saveset. 

Includes a baseline backup report after 
the history report. 

Displays command line options for 
ebreport history. 

Skips backups thai failed or are in 
progress. 



Displays the amount of data that was 
actually backed up. 

Note: The backup size that this report 
provides may be inconsistent with the 
recover^' summary size. The algorithms 
that are used to calculate recovery size 
and backup size are different. 



EDM Software Reference 



16-18 



Backup Reports and Log Files 



Sample Backup HiStOry Report Figure 16-4 shows a sample report that is generated by: 
# ebreport history -recent 

for an EDM called fig that backs up two templates (schedules): 
Generic and Server. The Server Template uses both a Primary 
media set (trailset) and an Alternate. 



Figure 16-4 EDM Backup History Report 

EDM Backup History Report for server edm at Sept 30 14:19:52 1998 

**** Work Items for Template Generic, Primary Trailset **** 
**Item "vigo:/work" for client "vigo" 

Time Lvl ID Status Entries Expires Rcvr 

10/19/98 16:12 0 72768A4B. 32F65536 complete 210/20/98 
10/13/98 16:04 0 72768A4B. 32F65406 complete 210/14/98 
:**** Work Items for Template Server, Primary Trailset **** 
**Item "fig:/" for client "fig" 

Time Lvl ID Status Entries Expires Rcvr 

10/14/98 16:12 9 72768A4B.3329BF58 unsorted 405310/15/98 NO 
10/ 6/98 10:40 0 72768A4B. 331EE55C complete 525010/ 7/98 
10/12/98 23:36 0 72768A4B. 33029A9D complete 500710/17/98 



**** Work Items for Template Server, Alternate Trailset **** 
**Item "fig:/" for client "fig" 

Time Lvl ID Status Entries Expires Rcvr 

10/19/98 0:39 9 727 6BA4B . 330A9265 complete 5045 10/23/98 
10/13/98 16:35 0 727 68A4B . 33038955 complete 5006 10/17/98 



10/30/98 20:00 0 72768A4B.32C9B7ED complete 



All backups with complete and delta listings are available for 
restoring and appear in the EDM Restore window. 
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Backup Disaster Reports At the completion of every LOCAL_DATABASE backup (the 
backup of the EDM Backup database), the script 
/usr/epoch/EB/config/loca]_db_c]eanup automatically 
generates a minimal disaster report. By default, this report is e- 
mafled to all EDM Backup administrators, appended to 
/usr/epoch/EB/config/disaster-reportJog, and printed to the 
default system printer. 

The minimal disaster report provides the essential information 
you need to perform a disaster recovery on the server. It is a 
subset of the full disaster report which is generated by the 
command ebreport disaster. You should run a full disaster 
report once every backup rotation and whenever significant 
system changes are made. 

Refer to Chapter 19 ""Being Prepared for a System Disaster"" for 
instructions on preparing for a disaster. See Chapter 20 "Recov- 
ering a Server from a Disk Failure" and Chapter 23 "Recovering 
a UNIX Client from Disk Failure" for instructions on recovering 
a server and a client. 

Figure 16-5 shows selections from the sections of the EDM 
Backup FULL disaster report. It contains die following sections: 

• Local database volumes • List of installed clients 
report 

• Media report • Library Manager configu- 

ration data 

• Backup history report • Filesystem table (/etc/vfstab) 

• Baseline backup history • Locally mounted disks 
report (for HSM systems) 

• Backup coverage report • HSM local configuration 

• Backup installation report • The root crontab file 

• Backup configuration files 
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Figure 16-5 EDM Backup FULL Disaster Report 

EDM Backup FULL Disaster Report for server "bilbo" on Sept 8 11:16:16 199* 
LOCAL_DAT ABASE Backup Volumes Report 

The following volumes contain the most recent LOCAL_DAT ABASE backup 
which will be required in the event of a Disaster Recovery: 
Saveset ID 7271F980 . 2FAD095E for LOCAL_DAT ABASE backup on 9/7/98 13:54 
bilbo_pri_dlt #0012 (50BE6FE05346D06C) - currently in library unit 
"at_dlt_32 64_0", slot #7 

bilbo_pri_DLT #0013 (EBDD020907E7982C) [duplicate] - currently 
in library unit "at_dlt_3264 _0", slot #3 

This LOCAL_DATABASE backup will require 40.9 MB of disk space to be recovered. 

EDM Backup Media Report for server bilbo on Sept 8 11:16:17 1998 Media 
Report options: none Report 
Summary of all media, listed by media rotation groups 

Rotations for Template "bilbo", Trail "bilbo_pri_dlt", Primary Trailset 

08/24/98 14:06 Rotation ID: E1BE6F9E. 22C1253E . 00000200 . A8O4A0B9, 88 backups, 
Media duplication not used 

*Vol ID: 50BE6FE0534 6D06C, media: DLT tape, number 0012 
Vol ID: E1BE6F9E22C1253E, media: DLT tape, number 0011 

Rotations for Template "argon", Trail "argon_alt_dlt", Alternate Trailset 
08/22/98 20:03 Rotation ID: 34BE6662 . C1CEE018 . 00000200. 48080A35, 1 backup, 
Media duplication not used 

*Vol ID: 34BE6662C1CEE018, media: DLT tape, number 0009 
Vol ID: E1BE6F9E22C1253E, media: DLT tape, number 0011 

Rotations for Template "argon". Trail "argon_alt_dlt", Alternate Trailset 
08/22/98 20:03 Rotation ID: 34BE6662 . C1CEE018 . 000002 00 . 48080A35, 1 backup, 
Media duplication not used 

*Vol ID: 34BE6662C1CEE018, media: DLT tape, number 0009 



Local 
Database 
Volumes 
Report 
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EDM Bac 



: March 8 11:16:21 1998 



Lvl IDStatus Entl 



9/ 7/98 17:58 0 7271F980 . 2FADOB70 complete33C 
BDBE8F4 8.D50C5B38. 002 3CD00 . F40D4AOA 

9/ 6/98 17:58 9 7271F980 . 2FABB9E6 delta 4 9/11/98 r 
BDBE8F4B.D50C5B38.0022D4 00. 610AF0E0 

9/ 5/98 17:58 9 7271F980 . 2FAA685E delta 24 9/10/98 
BDBE8F4 8 . D50C5B38 . 002 ICO 00 . B20A1983 

9/ 4/98 17:58 9 7271F980 . 2FA91 6DA delta 1006 9/9/98n< 
BDBE8F4 8 . D50C5B38 . 002 0B3 00 . FF0C66BE 

9/ 3/98 17:58 8 7271F980 . 2FA7C582 delta 24 9/8/98nori 
BDBE8F4 8 . D50C5B38 . CO1F4E00 . FC0D0D5F 



12/98r,o 



**** Work Items for Template argon, Alternate 
**Item "argon" for client "cheetah" 
Time lvl ID Status Enti 

Directory ID 

9/22/98 20:02 0 7271 F980 . 2F999998 complete 
34BE6662.C1CEE0 18. 00000500. 4B0EB4 53 



32434 9/24/98 



**** Baseline Backups for Template Servei 
**Item "fig:/catalogs" 

Time Lvl ID Stal 

9/ 5/98 10:23 Bl 72768A4B . 32F8A612 pari 



Baseline Backup 
History Report 
(for HSM 
systems) 



/ciientjiatal" 

Lvl ID Status 

41 Bl 72768A4B.32F90C9A no cat 

23 Bl 72768A4B.32F8A611 no cat 

56 Bl 72 7 68A4B.32F7DADA partial 
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EDM Backup Coverage Report for server adam at Sept 8 11:16:23 1998 Coverage 
Report options: none Report 
Filesystems currently backed up: CurrentMaxCurrentMax 

adam:/ 4381/41536 files, 50.3 MB/ 74. S MB adam:/datal 27/ 63152 files, 3. 4 MB/ 250.0 
MB adam; /data2 21/ 63152 files, 3.3 MB/250.0 MB 

hamster:/ 17854/215040 files, 600.1 MB/ 778.2 MB negril:/ 3685/ 98176 files, 64.1 
MB/ 187.9 MB negril: /data 5/ 1S1872 files, 1.3 MB/ 750.8 MB 

Total: 17 filesystems backed up 62480/ 2202176 files, 1.4 GB/ 6.9 GB 

EDM Backup Installation Report for server adam at Sept 27 14:23:26 1998 
Report options: -all 

Installation 

EDM Backur. n.vrpntlv n,nnim fi n n n Report 



/usr/epoch IS A SYMLINK to /ep_usr/epoch 
/usr/epoch/EB is a real directory under /ep_usr /epoch 
/usr/epoch/GENDJR IS A SYMLINK to /home/epoch 

/usr/epoch/EB/adam is a real directory under /usr/epoch/EB 
/usr/epoch/EB/bin is a real directory under /usr/epoch/EB 
/usr/epoch/EB/catalogs IS A SYMLINK to /home/epoch/EB/catalogs 

The local client is of the type: sun_sun4_v55_srv 

The client backup username is: ebadmin 

The user ID for ebadmin is: 24375 

The group ID for ebadmin is: 25 

The home directory for ebadmin is: /usr/epoch/EB 

Client negril is of type sun_sun4_v55_emc (5.0.0.0) installed 1998 Sept 13 16:06:21 
Client adam is of type sun_sun4_v.55_srv (5.0.0.0) installed 1998 Sept 27 13:24:46 
Client hamster is of type hp_700_v9 (5.0.0.0) installed 1998 Sept 27 13:55:29 

End of EDM Backup Installation Report for server adam at Sept 27 14:23:26 1997 
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Displaying current EDM Backup configuration... 

Sept 8 11:16 1998 /tmp/eb.cfg Page 1 Backup 

Configuration 
Files 



ebserver: "bilbo" 



client backup 
backup admini 



/* end startup parai 



((Clients Installed 



, times tamp, len, method, invocations , platform, RMS, vlength, versa c) 



', wildcat, 837787783, 7, edmlink, 0, 99, 0, 7,5.0.0.0,; 
i, fish, 842992815, 7, netware, 10, 113, 0, 7,5.0.0.0,; 
5, berlin, 850748622, 7 , netware , 10 , 53 , 0, 7,5.0.0.0,; 
',warthog, 850776740, 7, netware, 0 , 113, 0 , 7,5.0.0.0,; 
i, zero, 850777296, 7, netware, 0, 114, 0, 7,5.0.0.0,; 
\ hamster, 851018343, 3, rsh, 0, 75, 0, 7,5.0.0.0,; 
>, jumper, 856192150, 7 , edmlink, 0, 107, 0, 7,5.0.0.0,; 
!, vigo, 856385813, 7, edmlink, 0, 109 , 1 , 7,5.0.0.0,; 
], chipmunk, 857155162, 3 , rsh, 1 , 97 , 0, 7,6.0.0.0,; 
5, negril, 858032953, 7 , edmlink, 0, 1 09, 1, 7,6.0.0.0,; 
!, indianapolis, 858725141, 7, netware, 1, 53, 0, 7,6.C.0.( 
5, fig, 859312730, 6, direct, 0, 108, 1, 7,6.0.0.0,; 
5, bolton, 859571785, 7 , edmlink, 0, 93, 0 , 7,6.0.0.0,; 
/, pilgrim, 859821588, 7, edmlink, 0, 99, 0, 7,6.0.0.0,; 
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L offline_0 
L off site J) 
L at_dit_32 6<S_Q 
D at_dlt_32 64_0 
D at_dlt_32 64_0 
D at_dlt_32 64_0 
L hp_mf_cl7xx_0 
D hp__mf_cl7xx_0 
D hp_mf_cl7x>:_0 
D hp_mf_cl7xx_0 



_cl7x: 



enabled 
enabled 

synced 
enabled 
enabled 
enabled 
enabled 



Library 
Manager 
Configu ratio 



Sept 21 10:51 1998 /etc 


/vfstab Page 1 








/etc/vfstab 






FS 


fsck 






tto mount to fsck 
# 




type 


pass 




t options 


#/dev/dsk/cld0s2 /dev/r 


dsk/cld0s2 /usr ufs 


1 


yes 






fd - /dev/fd fd 












/proc - /proc proc 












/dev/dsk/c0t3d0sl - - 


swap - n 










/dev/dsk/c0t3d0s0 


/dev/rdsk/c0t3d0s0 


/ 


ufs 


1 




Zdev/dsk/c0t3d0s6 


/dev/rdsk/c0t3d0s6 


/usr 


ufs 






/dev/dsk/c0t2d0s3 


/dev/rdsk/c0t2d0s3 




- ufs 




yes 


/dev/dsk/c0t3d0s5 


/dev/rdsk/c0t3d0s5 


/home 


vxf s 






/dev/dsk/c0t2d0s0 


/dev/rdsk/c0t2d0s0 


/datal 


vxf s 


5 


yes 


/dev/dsk/c0t2d0sl 


/dev/rdsk/c0t2d0sl 


/data2 




6 




/dev/dsk/c0t3d0s7 


7dev/rdsk/c0t3d0s7 


/homel 


ufs 


7 


yes 


swap - /tmp tmpf 


yes 
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Displaying locally 

/ (/dev/dsk/c0t3d0s0 : 

153534 total blocks 50292 fr< 

37126 free files 8388632 filesys id 

ufs fstype 0x00000004 flag 

/usr l/dev/dsk/c0t3d0s6 ) : 

769694 total blocks 432834 free blocks 

177771 free files 8388638 filesys id 

ufs fstype 0x00000004 flag 



8192 block size 1024 frag size 
34952 available 41536 total files 



255 filename length 



Locally 

Mounted 

Disks 



8192 block size 1024 frag size 
355874 available 192576 total files 



255 filename length 



/home !/dev/dsk/c0t3d0i 
495936 total block: 
21507 free files 
vxfs fstype 0x00000004 flag 



8192 block size 1024 frag size 
17 6534 free blocks 150656 available 23840 total fii 
8388637 filesys id 

255 filename length 



EpochMigration Local Configuration 
EpochMigration System C 
EnabIe_stage__out K 



Enable self describing 



HSM Local 
Configuration 
(HSM is optional 
with EDM) 



Staging trail "PubsTrai 1_1 " 

Stage outs enabled: Y Media: 
Self-Describing enabled: N 
Enable HWM LWM PSWM Del a; 



95 



80 



95 88 80 



Mn tpoint 

defaults for PubsTrail_l 



EpochMigration Current Migration Volumes 
Current primary staging volumes are: 



Staging trail "PubsTrail_l" 
Sequence: 14 Mside: 1 Vol id: 



1CC39F59912E6A9 Nblocksavail : 314529 



Staging trail "PubsTrail_2" 

Sequence: 13 Mside: 1 Volid: 89CC2F69030965E2 Nblocksavail : 314529 
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tident"<? !#} rootl. 1193/04/08 SMI"/* SVr4.0 1.1.3.1*/ 

„ m , rootcrontab 

if The root crontab should be used to perform accounting data collection 
# 

0 2* * 0,4 /etc/cron.d/logchecker 

5 4**6 /usr/lib/newsyslog 

15 3 * * * /usr/lib/fs/nfs/nfsfind 

t Invoke EDM Backup backup program tEPCebs 

45 13 * * * /usr/epoch/EB/bin/ebbackup bilbo >/dev/null 2>&1 tEPCebs 

# Invoke EDM Backup backup program lEPCebs 

00 14 * * * /usr/epoch/EB/bin/ebbackup argon >/dev/null 2>Sl tEPCebs 

# Invoke EDM Backup backup program tEPCebs 

15 14 * * * /usr/epoch/EB/bin/ebbackup lucifer >/dev/nuil 2>&1 tEPCebs 

# Invoke EDM Backup catalog expiration program tEPCebs 

30 00 * * * /usr/epoch/EB/bin/ebexpire -expire -purge >/dev/m;ll 2>&1 TEPCebs 
fr Invoke EDM Backup catalog cleanup program tEPCebs 

00 1 * * * /usr/epoch/EB/bin/ebcatclean -fix_saveset >/dev/null 2>&1 tEPCebs 

t Invoke EDM Backup LOCAL_DAT ABASE validity check program tEPCebs 

00 3 * * * /usr/epoch/EB/conf ig/local_db_warning >/dev/null 2>Sl tEPCebs 

#40 * * * * /usr/epoch/lib/epnewlog 500000 > /dev/null 2>4l#EPCgl 

#00 23 * * 6 /usr/epoch/lib/epnewlog > /dev/null 2>&l#EPCgl 

#00 07 * * * /usr/epoch/lib/eptrunclog root > /dev/null 2>sl#EPCgl 

#30 08 * * * /usr/epoch/lib/epcleanup > /dev/null 2>£l#EPCgl 

40 * * * * /usr/epoch/lib/epnewlog 500000 > /dev/null 2>&l#EPCgl 

00 23 * * 6 /usr/epoch/lib/epnewlog > /dev/null 2>4l#EPCgl 

00 07 * * * /usr/epoch/lib/eptrunclog root > /dev/null 2>sl#EPCgl 

30 08 * * * /usr/epoch/lib/epcleanup > /dev/null 2>4l#EPCgl 

#50 8 * * * /usr/epoch/lib/ebfs/ebfs_cleanup > /dev/null 2>il#EPCebfs 

50 8 * * * /usr/epoch/iib/ebfs/ebfs_cleanup > /dev/null 2>Sl#EFCebfs 



11:16:16 1998 



End of EDM Backup Disaster Report 
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BaCkUP Baseline RepOrtS In HSM systems, ebreport baseline generates the baseline 

report which presents a summary of backup baseline activity as 
reflected in the saveset database. A status line is printed for 
every non-expired baseline backup of every work item selected 
by the arguments. 



Table 16-9 ebreport baseline Command Information 



Option 


Argument Definition 


Description 


-client clietUname 


client name is the client 
whose baseline history you 
want to display. 


Displays only backups that were 
created for the named client. 


-item workitemname 


workitemname is the client's 
work item for which you want 
to display baseline history. 


Displays only backups that were 
created for the named work item. If 
the name "*" is used, all work items 
are selected. Note that "*" must be 
quoted on the command line. 


-template templatename 


templatename is the backup 
template for which you want 
to see a baseline summary. 


Displays only backups that were run 
from the named template (schedule). 
If the name "*" is used, all work items 
are selected. Note that must be 
quoted on the command line. 


-completeness 




Also displays the backup 
completeness mode for each reported 
work item backup. 


-recent 




Lists only baseline backups since the 
second most recent level 0 backup for 
each work item. 


-since date [time] 
-until date 


date is the date in the format 
mmlddiyy. time (optional) is 
the time in the format 
[hh;mm[:ss]}. 


Limits the backup display to a range of 
dates. Use -since to show the backups 
that occurred on or after a particular 
date or use -until to display the 
backup that occurred on or up to a 
particular date. 
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ebreport baseline Command Information (Continued) 



Argument Definition 



Description 



-trailset primary | alternate 



Displays the work items that were 
backed up by a primary or alternate 
trailset. 

Displays only savesets for backups of 
the given level. You can enter up to 
two -level options in a single 
invocation, each occurrence adding 
another level to the selection set. 



Figure 16-6 shows a sample baseline report generated 
by ebreport baseline. 
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EDM Backup Baseline Report 



EDM Backup BaS' 
Sept 17 09:37: 
Report options 



ine History Report fo 

: 1998 

none 



Time Lvl ID Status 

9/16/98 18:00 Bl 55412298 . 2FB92071 no cat 



Primary Traiiset ■ 



Template default, Primary Traiiset • 



**Item "tesia: /data5" 










Time Lvl ID 




Status 






9/16/98 18:00 


Bl 


55412298 


2FB9206C 




9/15/98 18:00 


Bl 


55412298 


2FB7CEFA 


no cat 


9/14/98 18:00 


Bl 


55412298 


2FB67D77 


"io cat 


9/13/98 18:00 


Bl 


55412298 


2FB52BF5 


no cat 


9/12/98 18:00 


Bl 


55412298 


2FB3DA6C 


no cat 



BaCklip Completion EDM Backup prepares backup completion reports and can send 

RepOliS them to specified individual(s) via a shell script. (For setup 

details see "Backup Completion Script" on page B-79.) 
Figure 16-7 shows a sample backup completion report. 
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Figure 16-7 EDM Backup Completion Report 

Date, Time and 9/05/98 18:31:21 [ 2295 : /usr/epoch/EB/bin/ebbackup] 
Process ID it, Summary report for processing template "mwf" 
Template 

Date, Time and 9/05/98 18:31:21 [ 2295 : /usr/epoch/EB/bin/ebbackup] 

process ID#, pr0C essing of work item "cadl-all" via template "default" Level 0 

Work Item, SUCCEEDED 

Template, trailset was "cdr", trail was "cdr tape", 59 files backed uc in 
Trailset, Trail, 886KB 

Number of Fileso/os/ge 18:31:21 [ 2295 : /usr/epoch/EB/bin/ebbackup] 

Backed up and processin g of work ltem » C ad2-all" via template "default" 

Number of kb SUCCEEDED 

Used trailset was "cdr", trail was "cdr tape", 312 files backed up 

in 55809KB 

9/05/98 18:31:21 [ 22 95 : /usr/epoch/EB/bin/ebbackup] 
processing of work item "cad3-all" via template "default" 
SUCCEEDED 

trailset was "cdr", trail was "cdr tape", 10257 files backed up 
in 135514KB 

9/05/98 18:31:21 ( 2295 : /usr/epoch/EB/bin/ebbackup] 
processing of work item "cad4-all" via template "default" 
SUCCEEDED 

trailset was "cdr", trail was "cdr tape", 25306 files backed up 
in 203749KB 



The sei-ver eb_server_config installation procedure creates the 
mailok script to which it passes the backup completion infor- 
mation. The script mails a completion statement to individuals 
responsible for backup operations, and/or writes them to a log. 

Because the ebbackup program mails these reports immedi- 
ately after a backup, you can read them as soon as the backup 
completes. 
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Backup Failure Reports Whenever EDM Backup encounters an error that prevents 

backup completion (for example, a client system has crashed), 
it generates a backup failure report. (For setup details see 
"Backup Failure Script" on page B-80.) 

The EDM Backup program can send backup failure reports to 
specified individuals via a shell script. Because EDM Backup 
mails these reports whenever a failure occurs, you are notified 
of a failure as soon as it happens. On the other hand, if you 
don't receive one of these reports, you can assume your 
backups are successful. When you receive a backup failure 
report, you should fix the problem with die client system. 
However, EDM Backup continues to back up all other clients in 
the backup template (schedule), skipping those that had a 
problem. 

Figure 16-8 shows a sample backup failure report. 



Figure 16-8 EDM Backup Failure Report 

Date, Time, 9/06/98 06:22:21 [ 3423 : ebbackupd errno=35{ Operation would 

Process ID #, Error block), ec=0xl9] Workitem "docl-ali" backup TIMED-OUT 
Number, Work Item 
Name, and Reason 
for Failure 



The server eb_server_config installation procedure creates the 
mailerr script to which it passes the backup failure infor- 
mation. The script mails a failure statement to individuals who 
are responsible for backup operations, and/or writes them to a 
log. 
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BaCklip Coverage RepOrtS The ebreport coverage command makes ir easy lor you to 

determine if new filesystems were added to client systems and 
if they are getting backed up. When the report lists a filesystem 
that EDM Backup is not currently backing up, and the 
filesystem is one that you want to backup, you'll need to edit 
the client's work item statement to add the filesystem to the list 
of backup files. 

Note: ebreport coverage reports on Unix and Windows 
NT filesystems only (no NetWare filesystems). 

You can use the ebreport coverage command to display 
backed up and non-backed up filesystems on EDM Backup 
clients. The ebreport coverage command displays the backup 
status of all filesystems or you can use the options to display the 
following information. 



Table 16-10 ebreport coverage Command Information 



Command 


Argument Definition 


Description 


-client cttentname 


clientname is the client whose 
backup history you want to 
display. 


Displays a single client's backed up and 
non-backed up filesystems. 


-completeness 




Shows what kind of data is being backed 
up (for resident files only). 


templatename 


templatename is the backup 
template (schedule) for which 
you want to display backup 
history. 


Displays a backup template's non-backed 
up filesystems; with the templatename 
option displays the backup status of the 
specified template(s') filesystems. 


-installed 




Shows installed EDM Backup clients - 
displays all backed up and non-backed up 
filesystems in installed client list. 
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Figure 16-9 shows a report generated by ebreport coverage 
for three clients (adam, hamster, and negril), and identifies the 
fields in the report. 



Figure 16-9 EDM Backup Coverage Report 

EDM Backup Coverage Report for server adam at Sept 8 11:16:2: 



Fiiesystems currently backed up: Current Max Current Max 

adam:/ 4381/ 41536 files, 50.3 MB/ 74.9 MB 

adam:/datal 27/ 63152 files, 3.4 MB/ 250.0 ME 

adam:/data2 21/ 63152 files, 3.3 MB/ 250.0MB 

hamster:/ 17854/ 215040 files, 600.1 MB/ 778.2 MB 

negril:/ 3685/ S8176 files, 64.1MB/ 187.9MB 

negril:/data 5/ 191872 files, 1.3 MB/ 750.8 MB 

negril: /datal 4/ 191872 files, 1.3 MB/ 750.8 MB 



Total: 17 filesyst 



VolUITIC Reports The dbreport reportname command generates reports from 

the system administration database. 

Note: Ordinarily, only privileged users (those running as 
root) can run dbreport, 
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Some of these reports are listed in Table 1.6-11, to see a full li 
of reports see the dbreport man page. 



dbreport Command Information 



Report Name Description 



Generates a report of all the volumes known to the system. 

The fields of the report describe the type of media, the name of the application that 
currently owns die volume, the name assigned to tire volume, the sequence number of die 
volume, the side of the volume, and the barcode of the volume, if any. 



available 
appl_usage 



report of just thof 
Generates a report of applicati 



mently available for allocation. 



volume usage s 



The fields of the report are the application name, the volume name, the media type, the 
sequence number, the side, barcode, the number of blocks available, used, and stale in 1 
KB units, the percentage of the volume which is stale data, and the number of files used 
and stale on the volume. 

Generates a report of all media in system library units. 

The report is sorted by application, media type and application-dependent name. 

Generates a report of all media not in any system library unit. 

The report is sorted by application, media type and application-dependent name, 

Generates a report of all media which has been moved to offsite storage. 

The volumes in this category can be re-introduced to the system by being injected into a 
library unit. 

The report is sorted by application, media type and application-dependent name. 
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dbreport Command information (Continued) 



Report Name Description 



ism Generates a report of staging volume usage 

The fields of the report are the volume name, sequence number, side, barcode, the 
number of blocks used and stale in 3 KB units, the percentage of the volume which is stale 
data, and the number of files used and stale on the volume. 

jaseline Generates a report of baseline volume usage statistics. 

The fields of the report are the volume name, sequence number, side, barcode, the 
number of blocks used and stale in 1KB units, the percentage of the volume which is stale 
data, and the number of files used and stale on the volume. 

rompaction Generates a report you can use to estimate the staleness of volumes in order to determine 
which HSM volumes to compact with the emcompact utility. 



Log Files You can access backup log files directly and monitor them or 

review them for trotibleshooting. For example, use tail -f to 
monitor progress during processing and use vi or other editor 
to review logs at a later time. 

When filled, the oldest ten percent of these files is deleted on 
an ongoing basis. 



Server Log Files EDM Backup automatically creates log files in the directory 

/usr/'epoch/EB/log on the EDM Backup server. 
• The backups.log file contains information about backup 
operations. EDM Backup adds information to this file each 
time it backs up a template's work items. Selected notifica- 
tions that appear in this log file also appear in other backup 
reports. It accumulates detailed shutdown and stamip infor- 
mation each time a database work item is backed up. 
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Every two minutes ebbackup reports the average rate in 
KB/s for ALL work items being backed up. This Kite is 
affected by process timing, data buffering, and overhead in 
ebbackup. If you want to see the rate for a specific tape 
drive, see the EDM Library Unit Manager window which 
reports on an active drive every thirty seconds. 
The recoveries.log file contains file restore startup and 
completion notifications. Use tJie.se files for comprehensive 
information about backup and restore activities on your 
EDM server. 

The ebcai.log contains startup and shutdown times for 
catalog processing and output from eb expire and 
ebimport. 

The lemplaie_name \og records backup information for a 
single template. 

Whenever you want to see the backup history of a single 
backup template (schedule), use the template_name.log 
file. The information in this log file varies depending on the 
logging level you specified in the configuration database 
(see "Server Log File" on page B-78). Thus, you can use the 
file to view a history of backup-related events for a single 
template. 

The default log file is located in 

/usr/epoch/EB/log/defaul t_template.log. 

The default logging level, slats, reports when each client 

backup or restore begins, and includes periodic progress 

indications. 

There are five logging levels. Use the debug and per file 
levels to diagnose problems only when instructed by 
customer service. 
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Local Client Log Files 



Remote Client Log Files 



Other Logs 



EDM Backup automatically creates two log files on the EDM 
Backup client: the backups.log and recoveries.log in the 
directory /usr/epoclVEB/CUENT_HOME/c//e?7/. The 
backups.log file contains an audit trail of backup-related activ- 
ities listed in chronological order. The recoveries.log file 
contains an audit trail of rest ore- related activities listed in 
chronological order. 

• backups.log accumulates detailed scanning information 
each time a local work item is backed up. 

• recoveries.log records general start and end notifications for 
restore processing each time a local work item is restored. 



On die remote clients, backups.log and recoveries.log files 
reside in the directory 

/usr/epoch/EB/CLlENT_HOME/c//£?»rj2fl;??e. They record 
network backups and restore operations. 



Other logs record volume management and other system 
activity: 

• System logs are located in /var/adm 

• System logs are archived in /usr/epoch/adm 

• Circular logs are located in /usr/epoch/adm/circular 
System logging is configurable in /etc/syslog.conf. 
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Part IV 

Command Line 
Interfaces 



4 ^9 Configuring 
I m Library 

Managers 



When yon change EDM configuration by adding or removing a 
library unit, you need to reconfigure the software to recognize 
the change. 

This chapter describes the script that you use to install device 
drivers and configure Library Managers for library units that are 
connected to the EDM. 

The chapter describes the following tasks: 

• Using the lmconfig "Utility 

• Listing Library Managers 

• Installing Device Drivers 

• Updating Device Drivers 

• Removing Device Drivers 

• Configuring a Library Manager 

• Deconfiguring a Library Manager 
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Using the Imconfig Utility The Imconfig utility, enables you to: 

• list currently configured Library Managers 

• install, update, and remove device drivers 

• configure and deconfigure library Managers 

• access a help option that briefly describes the main menu 
entries 

(Refer to the Imconfig man page for more information about 
this utility.) 

Note: Imconfig is located in /usr/epoch/bin. Make sure 
that this pathname is defined in your PATH 
environment variable. 

To start the configuration script, log in as root and enter the 
following command to display the main menu. In this menu, 
you select the configuration you want to perform. 
# Imconfig 



EMC LIBRARY MANAGER CONFIGURATION TOOL 
Main Menu 

nt Library Manager configure- 



1 LIST 

2 INSTALL 

3 UPDATE 

4 REMOVE 

5 AUTOCONFIG 

6 DECONFIGURE 

7 HELP 

Choose the configuration operat 



EMC dr: 
EMC drivers 
EMC drivers 

Automatically configure all library uni- 
a Library Manager 



. you 



'ant (1, 2, 3, 4, 5, 6, 7, q 
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Listing Library Managers When you choose 1 LIST from the main menu. Library Managers 
that are currently configured in /'usr/epoch/etc/lm appear. 
Imconfig lists the name of the Library Manager and the device's 
SCSI address for the robot and each drive, as shown in the 
following example: 

Imconfig completed configurations: 

offline_0 

of fsitej) 
at_452_Q 

rO: 0 2 2 0 

dO: 0 2 3 0 

dl: 0 2 4 0 

d2: 0 2 5 0 



Library Manager Name The Library Managers name identifies the manufacturer, drive 

type, and model number of the device. 

Note: In releases previous to EDM 4.5.0, the Library 

Manager name includes the drive type (DLT. DTF, 
HITC etc.): for example, "at_dlt_452_0." 

For example, the Library Manager name, at_452_0, has the 
following meaning: 



Manufacturer of the automated tape library 
unit: ATL Products. 

Manufacturer's model number: in this 
example, the ACL 4/52 automated tape library 
unit. (4 drives/52 slots) 

Indicates the first Library Manager that is 
configured for this library unit type. The suffix 
increments for each additional library unit of 
this type that you configure. 
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SCSI AddreSS The SCSI address includes the system board number, SCSI bus, 

SCSI target ID, and logical unit number (LUN) of the library unit 
robot and drive(s); for example: 

rO: 0 2 2 0 
dO: 0 2 3 0 

System Board # I I 

SCSI Bus 1 

SCSI Target ID ' 

LUN 

In this example, the library unit's robot and drive are on system 
board 0, SCSI bus 0; the robot's SCSI target ID is 0, and its LUN 
is 0. Hie library unit has one internal drive at SCSI target ID 1, 
LUN 0. 



Installing Device Drivers When you choose 2 INSTALL from the main menu, lmconfig 

installs the device drivers into the /devices directory. You must 
install device drivers before you configure a Library Manager. 
This option requires that at least one library unit be connected 
to the server and operational. 

To install device drivers, use the following procedure. 



EDM Software Reference 



17-5 



Installing Device Drivers 



I. Choose 2 INSTALL from the main menu. A prompt asks yc 
to confirm the installation: 



Main Menu 

1 LIST current Library Manager configure 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library 

6 DECON FIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want (1,2,3,4,5,6,7 
About to install ail EMC drivers. 
Do you wish to continue (y,n)? y 



2. Enter y to begin driver installation. (Note that driver names 
vary by platform.) The script displays several messages that 
confirm driver installation. 

Modifying kernel driver. conf files 
Modifying /kernei/drv/st , conf 

Installing drivers 
Installing driver mo 
Driver mo installed 
Installing driver sjb 
Driver sjb installed 

Note: Ignore messages that indicate failure of mo driver 
installation. 

3. After the drivers are installed, shut down the system to the 
PROM level by entering the following command: 

# shutdown -y -i6 -gO 

This command enables a reconfiguration reboot of the 
server. 

4. After EDM shuts down and reboots, log in as root and 
restart lmconfig. 



EDM Software Reference 



17-6 



Configuring Library Managers 



The main menu appears, as shown: 
EMC LIBRARY MANAGER CONFIGURATION TOOL 
Main Menu 

1 LIST current Library Manager conf iguratio 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want {1,2,3,4,5,6 



EDM probes the bus for all attached hardware and assigns 
device nodes in the filesystem that represent the devices 
that are found. It also configures the logical namespace in 
/dev and the physical namespace in /devices. 
5. Select 5 AUTOCONFIG to configure Library Managers 
automatically for the attached library units. Refer to 
"Configuring a Library Manager" on page 17-8 for this 
procedure. 



Updating Device Drivers Choose 3 UPDATE from the Imconfig menu to reinstall device 
drivers. You must update the device drivers after updating the 
EDM software or updating the module that contains the drivers. 

When you update device drives, no Library Manager 
reconfiguration is required. 

To update the device drivers: 

1. Choose 3 UPDATE from the main menu. 

2. Confirm the update at the prompt. 
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ReillOVing DeViCe Drivers Choose 4 REMOVE from the lmconftg menu to remove all 
device drivers from the /devices directory. You must remove 
device drivers before deinstalling die EDM software. 

To remove device drivers, select 4 REMOVE from the main 
menu. Then confirm the removal at the prompt 

Sample output appears below. 



1 LI ST current Library Manaaer configtr 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all librar 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want 
(l,2,3,4,5,6,7,q)? 4 
About to remove all EMC drivers. 
Do you wish to continue (y,n)? y 

Modifying kernel driver. conf files 
Modifying /kernel /drv/st . conf 

Removing drivers 
Removing driver mo 
Removing driver sjb 
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Configuring a Library Use the AUTOCONFIG option of lmeonfig to configure 

Manager a Library Manager automatically for each library unit that is 

attached to the EDM. 

AUTOCONFIG verifies that offline and offsite daemons are 
configured. Then it searches for all device nodes in the 
system, acquires all necessary information, and configures a 
library manager for each library unit. AUTOCONFIG automati- 
cally unloads all drives and puts the media into empty slots. 

Because the operation is automatic, you do not have to know 
the system board numbers, SCSI bus numbers, target IDs, and 
LUN numbers for each device. 

The lmeonfig utility creates a subdirectory in /usr/epoch/etc/lm, 
copies a sample configuration file into the directory and 
modifies it, creates a link to the executable file, and adds the 
pathname of the new Library Manager to the Volume Manager's 
configuration file. (See Appendix C "Volume Management 
Configuration Files'' for more information about how the 
Volume Manager uses the vm.cfg file.) 

Note: You can also use enhanced lmeonfig to run 

AUTOCONFIG and tell it not to ask any questions. 
If it detects any drives with media in them, 
AUTOCONFIG unloads the media automatically 
without asking you, and configures all unconfigured 
library units. You run enhanced lmeonfig by using 
the command lmeonfig -A. 



Preparing for Configuration Before you configure Library Managers), verify that: 

• your hardware configuration is valid 

• library units are properly cabled, powered up, and online 

• device drivers were installed successfully and EDM 
rebooted 

• all library unit drives are operational 

• at least one piece of media is loaded in each Library unit 



EDM Software Reference 



17-9 

Configuring a Library Manager 



Running Imconfig To start configuration, do the following: 

1 . Be sure you are logged in as root. 

2. Enter the following command to display the Imconfig main 
menu: 

# Imconfig 

3. Choose 5 AUTOCONF1G from the main menu and then 
confirm autoconfiguration at the prompt. 

EMC LIBRARY MANAGER CONFIGURATION TOOL 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library uni 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want 
(1, 2, 3, 4, 5, 6, 7, q)? 5 

Make sure the following are all true before continuing: 

1. The library units were set up, cabled correctly, powered on 
and online. 

2. Drivers have been successfully installed and the system 
rebooted. 

3. All library unit drives are operational. 

4. At least one piece of media is in each library unit. 

5 . The BCS Calypso unit that has the library unit to be conf igurec 
must not be running any backups or have any opened streams t 
the drives. 

Would you like to continue with autoconfiguration {y,n)? y 
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If All Library Units Are AUTOCONFIG looks for unconfigured devices, active library 

Configured units, and loaded drives. If all library units are already 

configured, the following appears: 



Starting Autoconfig • 



Determining unconfigured devices: 100% 
Searching for active library units: 100% 

_autoconfiq failed: *** Error: No non-configured library units found 
autoconfig: No configuration done 
lirtconfig warning : AUTOCONFIG failed 

Nothing was done because all available library units are already- 
configured. 



If Media Is Found In Any Drive If AUTOCONFIG detects media in a drive it automatically 

unloads the drive and places the media into an empty slot. 
(Sample output follows.) 

Select y (yes) to continue with configuration. 

Note: If a mechanical problem does not allow the media 
to be moved, AUTOCONFIG fails. "If you cannot fix 
the problem, shut off the problem library unit and 
then run AUTOCONFIG again to configure the 
remaining library units. 
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Starting Autoconfig v3.0 



Determining unconfigured devices: 100% 
Searching for active library units: 100% 
Checking for loaded drives: 100% 



Found some drives loaded with media. 
Unconfigured drives must not have raedi; 



WARNING: The unload program will unload all 

unconfigured drives attached to this se. 



Would you like to unload the drive (s) (y,n)? y 

Searching for loaded drives in library unit: 
Vendor[ HP] Product! C1710T] :: Board Bus Target LUN [ 0 4 0 01 



Found 1 drives loaded with media 
Unloading 

Moving media from drive 0 to slot 6 



The Configuration PrOCeSS AUTOCONFIG displays a list of available library units that are 

not yet configured. At the prompt, enter "a" for all, or a 
comma -separated list to select some but not all of the listed 
1 ibrary units. 

AUTOCONFIG now configures all or selected library units. 
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Please choose which library units to configure : 



1. Vendor! HP] Product! C1710T] :: Board Bus Target LUN [0 4 0 0] 

Please enter a comma separated list of the library 
units you would like to configure, or 'a' for all : a 



Getting Info on Library Unit #0 : HP : C1710T : 6.10 

The robot on library unit 1 is located at: 

=== BOARD : 0 BUS: 4 TARGET : 0 LON:0 === 

Number of drives = 2 

Number of slots = 32 

Number of inlets = 1 

Media found in slot number 0 

Library unit supports drive to drive moves 

Using compatible configuration files: hp_cl7xx . attr / hp_cl7xx. 



Loading Drive 0. Please Wait 

Waiting for drive to be ready . . 

Found Drive 0 : HP : C1716T : 3336 

For your information, Drive 0 is located at : 

=== BOARD : 0 BUS : 4 TARGET: 4 LUN:0 === 

Using compatible configuration file for the drive: eo_worm. tmpJ 



Loading Drive 1. Please Wait 

Waiting for drive to be ready . . . 

Found Drive 1 : HP : C1716T : 3336 

For your information, Drive 1 is located at : 

=== BOARD : 0 BUS: 4 TARGET : 5 LUN : 0 === 

Using compatible configuration file for the drive: eo_worm. tmpJ 



Configuring library unit 

Enter physical location for LU qntm_x700_0 : Bl Lab 

Enter die physical location of the library unit; for example, 
"Bl Lab" as shown above. 



EDM Software Reference 



17-13 



Configuring a Library Manager 



AUTGCONFIG prompts you to accept or decline a default 
barcode for cleaning cartridges: 

Would you like to accept the EDM default 
barcode of CLNXXX for tape cleaners (y,n)[YJ? y 

If you answer y (yes), the Library Manager recognizes any tape 
with a barcode of CLNCOOO-999) as a cleaner by default and 
does not place it in the drive during an inventory. 

Note: To override this default you must answer n (no). 



Viewing Log Files After all library units are configured, Imconfig notifies you that 

configuration is complete. AUTOCONF1G then asks if you want 
to view the log files. If you answer yes, information for each 
library unit appears: 

Finished configuring library unit(s). 

Would you like to see the log files (y,n)? y 



= Library Unit Info 

= Vendor ID = HP 
= Product ID = C1710T 
= Product Rev = 6.10 



( Device name : Board/Bus/Target/LUM : Vendor ID : 
Product ID : REV ) 

Robot 0 : 0 4 0 0 : HP : C1710T : 6.10 
Drive 0 : 0 4 4 0 : HP : C1716T : 3336 
Drive 1 : 0 4 5 0 : HP : C1716T : 3336 



Selecting the Cleaner Barcode 
Default 
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Completing Imconfig After the library managers are configured, type q to exit the 

lmconfig utility. 



1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 AUTOCONFIG Automatically configure all library units 

6 DECONFIGURE a Library Manager 

7 HELP 

Choose the configuration operation you want 
(1, 2, 3,4, 5, 6, 7, q)? q 



Reboot the EDM system by entering die following: 
# shutdown -y -i6 -gO 

This important step starts the vmdaemon, and ebfsd and 
vmdupd daemons. EDM software does not run until these 
daemons start. 

A full inventory begins after the reboot; the time period for 
completing an inventor)' depends on the amount of media dial 
the library unit contains. 



Deconfiguring a Library When you deconfigure a Library Manager, Imconfig deletes the 
Manager Library Manager's subdirectory and its contents. You should 

deconfigure a Library Manager when you permanently remove 

a library unit from die server. 

To deconfigure a Library Manager, do the following: 
1 . Start lmconfig and choose 6 DECONFIGURE in the main 
menu. 
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2. Imconfig lists the currently installed Library Managers; at the 
prompt, select the one you want to remove: 

1 offline_0 

2 cffsate_0 

3 at_4 52_0 

4 hp_cl?xx_0 

Enter comma-separated choice (s) cn a single line (1, 2, 3, 4, q) 

3. Enter the numberCs) that correspond to the Library 
Manager(s) that you want to deconfigure (as shown in the 
example above). 

Note: If you inadvertently remove the offline or offsite 
Library Manager, Imconfig automatically adds it 
back for you. Just choose the CONFIGURE option in 
the Imconfig main menu. 

offsite_0 removed 
qntm_x7 00_0 removed 
hp_cl7xx_0 removed 
offline^O removed 



The utility removes the .Library Manager's subdirectory and 
its contents from /usr/epoch/etc/lm. It also deletes the 
Library Manager from the vm.cfg file and notifies the 
Volume Manager to reread the file and kill the associated 
LM daemon. 
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4. When the main menu appears, select q (quit) to return to 
the system prompt. 

Main Menu 

1 LIST current Library Manager configurations 

2 INSTALL EMC drivers 

3 UPDATE EMC drivers 

4 REMOVE EMC drivers 

5 CONFIGURE Manually configure a library unit 

6 AUTOCONFIG Automatically configure all library units 

7 DECON FIGURE a Library Manager 

8 HELP 

Choose the configuration operation you want (1 , 2, 3, 4, 5, 6, 7, 8, q)? 
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If YOU Have Trouble If a drive other than drive 0 fails while configuring a library unit, 

Configuring a Library Unit AUTOCONHG asks whether you want to configure the LU with 
the drives that AUTOCONHG was able to find (this number is 
less than the total number of drives that the LI J contains). 
Messages that are similar to the following appear: 

*** ERROR: Cannot find node for drive 1 

Drive 1 may have been loaded using a 
*** cleaning cartridge, or it may be damaged or disabl 

*** Configuration of library unit #0 has stopped. 

AUTO CON FIG could only find the first 1 drive (s) 

Would you like to configure the library unit 
with only 1 drive(s) (y,n)[N]? no 

If you enter n (no), configuration of the library unit stops: 

^autoconfig failed: *** Error: SCSI location of 
drive #1 was not found 

*•** Error: Unable to configure library unit 10 

If you enter y (yes), configuration completes with the drives 
that AUTOCONHG found. 

NOTE: There is a tape in drive 1 

Please shut down EDM server after AUTO CONFIG finishes, 
and manually remove the tape from the drive. 



If you want to configure more than one library unit at one time 
and AUTOCONHG fails because a volume is stuck in a drive, 
AUTOCONHG may have a problem while removing the volume 
from the drive. 

Turn off the library unit, remove the volume from the drive, and 
check the drive cables. Then restart EDM and restart 
AUTOCONHG. This enables AUTOCONHG to configure die 
remaining library units. 



If a Problem Occurs While 
Configuring Multiple Library 
Units 
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